Skills Retrospective
Review and improve skills based on conversation experience.
When to Trigger
This skill activates when user asks for:
-
"复盘 skills" / "review skills" / "总结 skills"
-
"Skills 有什么问题" / "What issues with skills"
-
"Improve skills" / "优化 skills"
-
"Skills 需要改进的地方"
Retrospective Workflow
Step 1: Identify Skills Used
List all skills loaded in this conversation:
-
tasknotes-skill
-
TaskNotes CLI integration
-
skill-creator
-
Base skill creation guidance
Step 2: Analyze Issues
For each skill, identify:
-
Command failures - What commands failed and why
-
Missing content - What should have been documented but wasn't
-
Incorrect guidance - What advice was wrong or misleading
-
Edge cases - What scenarios weren't covered
-
User confusion - Where user got confused
Step 3: Prioritize Improvements
Priority Issue Type Action
Critical Wrong/misleading info Fix immediately
High Missing critical info Add to SKILL.md
Medium Edge case not covered Add to troubleshooting
Low Clarity improvement Refine wording
Step 4: Document Findings
Create a summary in this format:
Skills Review - [Date]
[Skill Name]
Issues Found:
- [Issue description] - [Root cause]
- ...
Improvements Made:
- [Change] - [Location]
- ...
Still Missing:
- [What's still needed]
Common Issues to Watch For
Command Option Mismatches
-
Check tn --help for actual options
-
create doesn't support --priority , --tags , etc.
-
update --add-projects may silently fail
Path Handling
-
Chinese punctuation in paths (。) requires exact matching
-
.md extension may or may not be required
-
Use tn list --json to get exact IDs
Natural Language Parsing
-
∑ symbol causes parsing issues → use _ instead
-
Project names with - may be misinterpreted
-
Test with simple cases first
Actionable Improvements
Immediate Actions
-
Update SKILL.md with workaround for update --add-projects
-
Document project naming convention (underscore vs sum symbol)
-
Add exact ID extraction patterns
Documentation Updates
-
Add "Gotchas" section for known issues
-
Include command output examples
-
Document batch operation risks
Output Format
When presenting improvements:
Skills Review
tasknotes-skill
| Issue | Root Cause | Fix |
|---|---|---|
--add-projects silent fail | API bug | Use _ in project name during creation |
∑ parsing issue | Parser limitation | Use 拓扑灵犀_infra建设 instead |
skill-creator
| Issue | Root Cause | Fix |
|---|---|---|
| Missing skill-review | New requirement | Created skill-review |
Files Modified
/Users/oldwinter/.claude/skills/tasknotes-skill/SKILL.md/Users/oldwinter/.claude/skills/skill-review/SKILL.md
Integration with Previous Session
If this is a continuation of a previous session:
-
Read the previous skills review (if exists)
-
Verify improvements were actually implemented
-
Note any regression or new issues
-
Build on previous findings