# 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