diff --git a/plugins/engineering-playbook/skills/code-review/SKILL.md b/plugins/engineering-playbook/skills/code-review/SKILL.md index 4fecec3..96bb6ce 100644 --- a/plugins/engineering-playbook/skills/code-review/SKILL.md +++ b/plugins/engineering-playbook/skills/code-review/SKILL.md @@ -1,9 +1,6 @@ --- name: code-review -description: >- - Performs strict software code reviews for diffs, pull requests, branches, or - working trees. Use when asked to review code, find bugs, assess tests, enforce - coding standards, or catch Laravel delivery-layer boundary violations. +description: Reviews software changes and reports actionable defects. Use for an explicit code-review request. --- # Code Review diff --git a/plugins/engineering-playbook/skills/coding-standards/SKILL.md b/plugins/engineering-playbook/skills/coding-standards/SKILL.md index c2af7cf..44c0947 100644 --- a/plugins/engineering-playbook/skills/coding-standards/SKILL.md +++ b/plugins/engineering-playbook/skills/coding-standards/SKILL.md @@ -1,10 +1,6 @@ --- name: coding-standards -description: >- - Apply reusable coding standards while implementing, refactoring, reviewing, or - explaining software changes. Use when the user asks to follow project-wide - engineering conventions, enforce coding style, improve maintainability, add - tests, or keep behavior consistent across repositories. +description: Defines shared implementation and review standards loaded by the development and code-review workflows. --- # Coding Standards diff --git a/plugins/engineering-playbook/skills/creating-skills/SKILL.md b/plugins/engineering-playbook/skills/creating-skills/SKILL.md index f524b4c..e848df3 100644 --- a/plugins/engineering-playbook/skills/creating-skills/SKILL.md +++ b/plugins/engineering-playbook/skills/creating-skills/SKILL.md @@ -1,10 +1,6 @@ --- name: creating-skills -description: >- - Creates, edits, and maintains agent skills and their referenced resources. - Use when creating a new skill, editing SKILL.md, changing skill frontmatter, - or modifying files referenced by a skill such as references, scripts, or - assets. +description: Defines skill-authoring guidance loaded by development before skill or skill-resource changes. --- ## Source diff --git a/plugins/engineering-playbook/skills/development/SKILL.md b/plugins/engineering-playbook/skills/development/SKILL.md index 1eb1d13..c48c713 100644 --- a/plugins/engineering-playbook/skills/development/SKILL.md +++ b/plugins/engineering-playbook/skills/development/SKILL.md @@ -1,8 +1,6 @@ --- name: development -description: >- - Implement code changes from a user request or GitHub issue. Use when the user - asks an agent to build, fix, refactor, or develop a ticket, feature, or issue. +description: Implements software changes from a request or GitHub issue. Use when asked to change code or repository files. --- # Development diff --git a/plugins/engineering-playbook/skills/laravel-standards/SKILL.md b/plugins/engineering-playbook/skills/laravel-standards/SKILL.md index 492522c..8ca1bee 100644 --- a/plugins/engineering-playbook/skills/laravel-standards/SKILL.md +++ b/plugins/engineering-playbook/skills/laravel-standards/SKILL.md @@ -1,9 +1,6 @@ --- name: laravel-standards -description: >- - Coding standards for a Laravel application in a repository that may contain - multiple applications. Use when the agent is modifying or reviewing - code changes inside the Laravel application codebase. +description: Defines Laravel delivery and composition rules loaded by development and code-review for Laravel changes. --- # Laravel Standards diff --git a/plugins/engineering-playbook/skills/pull-request/SKILL.md b/plugins/engineering-playbook/skills/pull-request/SKILL.md index 727a1b2..369c539 100644 --- a/plugins/engineering-playbook/skills/pull-request/SKILL.md +++ b/plugins/engineering-playbook/skills/pull-request/SKILL.md @@ -1,9 +1,6 @@ --- name: pull-request -description: >- - Writes and creates small GitHub pull requests with Conventional Commit titles, - concise descriptions, and issue-closing references. Use when opening, - drafting, publishing, or preparing a pull request. +description: Creates concise GitHub pull requests with Conventional Commit titles and issue-closing references. Use when asked to open a pull request. --- # Pull Request diff --git a/plugins/engineering-playbook/skills/ticket-planning/SKILL.md b/plugins/engineering-playbook/skills/ticket-planning/SKILL.md index 81501f0..d9b843e 100644 --- a/plugins/engineering-playbook/skills/ticket-planning/SKILL.md +++ b/plugins/engineering-playbook/skills/ticket-planning/SKILL.md @@ -1,10 +1,6 @@ --- name: ticket-planning -description: >- - Draft concise GitHub issue plans in simple English before issue creation, - including blocker checks against open GitHub issues. Use when the user asks to - plan, write, shape, or prepare a ticket, issue, backlog item, feature request, - bug task, or implementation plan. +description: Drafts concise GitHub issues and checks blockers before creation. Use when asked to plan a GitHub issue. --- # Ticket Planning