ee0f4bd5d9
- Add comprehensive built-in commands reference (40+ commands) - Document argument handling ($ARGUMENTS, $1, $2, etc.) - Add bash execution syntax (! prefix) and file references (@ prefix) - Update frontmatter to official fields (allowed-tools, argument-hint, model, etc.) - Add Plugin Commands and MCP Slash Commands sections - Add SlashCommand Tool documentation for programmatic invocation - Add Skills vs Slash Commands comparison table - Create commit.md example with bash execution and context - Update existing examples to use official frontmatter format - Add OpenSpec proposal for change tracking
28 lines
1.2 KiB
Markdown
28 lines
1.2 KiB
Markdown
# Tasks: Update Agent Skills Lesson
|
|
|
|
## 1. Update Main README (03-skills/README.md)
|
|
|
|
- [ ] 1.1 Add "Managing Skills" section with viewing, testing, updating, removing guidance
|
|
- [ ] 1.2 Expand "Troubleshooting Guide" with debugging tips for skipped skills, YAML errors, script permissions, path formats
|
|
- [ ] 1.3 Add "Version History Best Practice" section with example
|
|
- [ ] 1.4 Enhance "allowed-tools" documentation with use cases and security examples
|
|
- [ ] 1.5 Add "Multi-File Skill Example" showing complex skill structure with multiple reference files
|
|
|
|
## 2. Update Blog Post (blog-posts/03-skills.md)
|
|
|
|
- [ ] 2.1 Add "Managing Skills" section mirroring README updates
|
|
- [ ] 2.2 Expand troubleshooting with debugging guidance from official docs
|
|
- [ ] 2.3 Add version history best practice
|
|
- [ ] 2.4 Enhance allowed-tools explanation
|
|
- [ ] 2.5 Add multi-file skill example
|
|
|
|
## 3. Update Example Skills
|
|
|
|
- [ ] 3.1 Add version history section to `03-skills/code-review/SKILL.md`
|
|
|
|
## 4. Validation
|
|
|
|
- [ ] 4.1 Verify all code examples are syntactically correct
|
|
- [ ] 4.2 Ensure consistency between README and blog post
|
|
- [ ] 4.3 Test that existing examples still work with updated documentation
|