chronicle-mcp: Skill for Claude Code

Review Upstream Skills

Fetch, diff, and reconcile custom skill updates from upstream source repositories into myskills/.

Workflow

flowchart TD
    Start["Trigger: /review-upstream"] --> Fetch["1. Fetch: node sync-upstream.js --all"]
    Fetch --> Triage{"2. Triage Skills"}
    
    Triage -->|"New Skill"| AskNew["Ask user: Add to official catalog?"]
    Triage -->|"Modified Skill"| DiffCheck["Compare local vs upstream diff & recommend action"]
    
    AskNew -->|"Approved"| ApplyAdd["node sync-upstream.js --apply <name> --action add --category <cat>"]
    
    DiffCheck --> Choice{"User Decision"}
    Choice -->|"Overwrite"| ApplyOverwrite["node sync-upstream.js --apply <name> --action overwrite"]
    Choice -->|"Keep Local"| Skip["Skip apply"]
    Choice -->|"Combine"| ManualMerge["Manually edit local SKILL.md"]
    
    ApplyAdd --> Cleanup["3. Clean pending: node sync-upstream.js --clear"]
    ApplyOverwrite --> Cleanup
    Skip --> Cleanup
    ManualMerge --> Cleanup
    
    Cleanup --> Sync["4. Sync: agents audit -a -p && agents distribute"]
    Sync --> Git["5. Commit & Push myskills"]

CLI Reference

Triage Rules for Modified Skills

For each modified skill, report to the user:

1. Summary of differences: What upstream added vs. what local customized.
2. Recommendation: State clearly whether to overwrite, keep local, or merge.
3. Options:
   • a. Keep local (reject upstream changes)
   • b. Overwrite (accept upstream version)
   • c. Merge (manually combine complementary improvements)