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
1.2 KiB
1.2 KiB
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