Skip to content

improve(generate-agent-skills): improve description and add reference index table #46

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

Closed
srbouffard wants to merge 1 commit into from
Closed

improve(generate-agent-skills): improve description and add reference index table #46

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
27 changes: 9 additions & 18 deletions skills/generate-agent-skills/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: generate-agent-skills
description: Architects, generates, and validates Agent Skills. Enforces specification and best practices. Used any time an agent skill must be created or updated.
description: "Creates and updates SKILL.md files with YAML frontmatter, workflow steps, and bundle resources. Scaffolds directories via scaffold_skill.py and validates via validate_skill.py. Use when creating a new agent skill, writing a skill.md, updating skill definitions, or generating skill templates."
compatibility: python3
allowed-tools: python3 ls grep cat mkdir
metadata:
Expand Down Expand Up @@ -334,23 +334,14 @@ After creating the skill, test and refine based on real usage.

---

## Knowledge Retrieval
## Reference Index

If questions arise during skill creation:

**Specification questions** (naming, structure, required files):
→ Read `references/SPECIFICATION.md`

**Best practices** (context economy, freedom scale, anti-patterns):
→ Read `references/BEST_PRACTICES.md`

**Templates and examples** (frontmatter, structure patterns):
→ Read `references/TEMPLATES.md`

**Workflow design** (sequential, conditional, iterative):
→ Read `references/workflows.md`

**Output formatting** (templates, examples, validation):
→ Read `references/output-patterns.md`
| Topic | File |
|-------|------|
| Specification (naming, structure, required files) | `references/SPECIFICATION.md` |
| Best practices (context economy, freedom scale, anti-patterns) | `references/BEST_PRACTICES.md` |
| Templates and examples (frontmatter, structure patterns) | `references/TEMPLATES.md` |
| Workflow design (sequential, conditional, iterative) | `references/workflows.md` |
| Output formatting (templates, examples, validation) | `references/output-patterns.md` |

**Do not hallucinate answers.** Always consult the authoritative sources.
Loading