Skip to content

docs(agents): update skill execution guidance for clarity and completeness #1205

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
khajavi wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs(agents): update skill execution guidance for clarity and completeness #1205

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -102,6 +102,7 @@ When waiting on PR checks, suppress watch output to avoid context bloat:
- Follow workflow phases in order
- Batch edits; keep sbt runs scoped to one project
- Update AGENTS.md if you find errors or gaps
- In the middle of executing a skill, if you discover a deviation from the skill's instructions, encounter missing information or unclear guidance, or discover a better approach than what was written, update that skill file to reflect what you learned.
Copy link

Copilot AI Mar 10, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This bullet introduces the term “skill” / “skill file”, but AGENTS.md doesn’t define what a skill is or where its file lives. To avoid ambiguity for new contributors, consider adding a short clarification (e.g., that skills are the .claude/skills/<skill-name>/SKILL.md files) and wrapping the long sentence for readability.

Suggested change
- In the middle of executing a skill, if you discover a deviation from the skill's instructions, encounter missing information or unclear guidance, or discover a better approach than what was written, update that skill file to reflect what you learned.
- In the middle of executing a skill (a `.claude/skills/<skill-name>/SKILL.md` file), if you discover a deviation from the
skill's instructions, encounter missing information or unclear guidance, or discover a better approach than what was written,
update that skill file to reflect what you learned.

Copilot uses AI. Check for mistakes.
- Document new data types in `docs/`; update existing docs when behavior changes
- **README.md is auto-generated.** Never edit `README.md` directly. Edit `docs/index.md` instead, then run `sbt --client generateReadme` to regenerate `README.md`.

Expand Down