claude-howto/openspec/changes/update-skills-lesson/tasks.md

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