skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
camacho/ai-skills710 installs

archive

Fills Outcomes & Learnings in a plan file and renames it to .done.md.

How do I install this agent skill?

npx skills add https://github.com/camacho/ai-skills --skill archive
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill automates the process of archiving project plan files. It appends outcomes and learnings to the files and uses git commands to rename and commit them within a designated workspace directory.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • ZeroLeakspass

    Score: 93/100 · 2 sections analyzed

What does this agent skill do?

Inputs

  • WORKTREE: absolute path to current worktree (resolve from session CWD or git rev-parse --show-toplevel)
  • Plan file path (default: most recent non-.done.md in $WORKTREE/ai-workspace/plans/)

Steps

  1. Find the plan file:

    ls -t "$WORKTREE/ai-workspace/plans/"*.md | grep -v '.done.md' | head -1
    

    If plan is already .done.md → error: "Already archived."

  2. Read the plan file to understand what was planned.

  3. Gather outcomes: Ask the user (or infer from git log + branch context):

    • What worked well?
    • What didn't go as planned?
    • What would you do differently?

    If user skips → write "Outcomes: not recorded" (don't block).

  4. Write Outcomes & Learnings section to the plan file:

    ## Outcomes & Learnings
    
    **Completed**: [date]
    
    ### What Worked
    - [bullet points]
    
    ### What Didn't
    - [bullet points]
    
    ### Learnings
    - [bullet points]
    
  5. Rename to .done.md:

    git -C "$WORKTREE" mv ai-workspace/plans/<name>.md ai-workspace/plans/<name>.done.md
    
  6. Commit the archive:

    git -C "$WORKTREE" add ai-workspace/plans/<name>.done.md
    git -C "$WORKTREE" commit -m "docs: archive plan <name>
    
    Co-Authored-By: Claude <model>"
    

Output: Confirmation that the plan is archived with path to .done.md file.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/camacho/ai-skills/archive">View archive on skillZs</a>