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:**
1. [Issue description] - [Root cause]
2. ...

**Improvements Made:**
1. [Change] - [Location]
2. ...

**Still Missing:**
1. [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

skill-review

Skills Retrospective

When to Trigger

Retrospective Workflow

Step 1: Identify Skills Used