Archive

Skriver sessionslärdomar till .archive/ÅÅÅÅ-MM-DD/ med taggad frontmatter och ett MEMORY.md-index

av ReScienceLab · ReScienceLab/opc-skills

Testad · Fungerar ★ 8.8/10

Archive — Skriver sessionslärdomar till .archive/ÅÅÅÅ-MM-DD/ med taggad frontmatter och ett MEMORY.md-index

Vad den gör

Archive fångar vad en arbetssession producerade — en buggfix, en deploy, en migrering — som en daterad markdown-fil under .archive/ÅÅÅÅ-MM-DD/ med YAML frontmatter (tags, category, related) plus en enradig post tillagd i ett .archive/MEMORY.md-index. Den utlöses när en betydande uppgift avslutas, när en knepig bugg löses, när användaren säger "archive this", eller när man frågar om ett problem löstes i en tidigare session. En medföljande SessionStart-hook läser .archive/MEMORY.md tillbaka in i kontexten så att tidigare anteckningar är tillgängliga i senare sessioner.

Testrapport

Hämtade skills/archive/SKILL.md (HTTP 200, 55 rader, frontmatter har name+description) och stickprovskontrollerade dess tre medföljande filer rått: references/TEMPLATE.md 200, hooks/hooks.json 200, hooks/load-memory.py 200 — alla existerar, inga hårdkodade maskinsökvägar, ingen curl|sh, ingen base64, ingen hemlig exfiltrering; load-memory.py läser endast $CLAUDE_PROJECT_DIR/.archive/MEMORY.md och skriver ut det som SessionStart additionalContext (så vad som än finns i den filen kommer in i kontexten — håll det betrott-lokalt). Trigger fick 5/5 på: SKA utlösas — "Archive this session, we finally fixed the CloudWatch log group permissions", "We just finished the ECS deploy, save the learnings so future sessions don't repeat this", "Have we hit this Alembic migration error before? check past session notes"; SKA INTE utlösas — "Compress the logs directory into a tar.gz archive and move it to backups" (annan betydelse av ordet), "Add a CHANGELOG entry for the v1.2 release" (repo-fil, inte .archive-anteckningar). För utdata körde jag en uppgift två gånger i ett scratch-projekt: baslinjen gav en enda fri form docs/session-notes-2026-07-21.md utan index, inga taggar, inga exakta kommandon, committad till repot; den skicklighetsföljda körningen gav .archive/2026-07-21/vercel-deploy-node-version-lockfile.md med tags/category frontmatter, ett Key Changes-block som innehöll den verkliga env-variabeln och pnpm/git-kommandona, en MEMORY.md-indexpost och en `.archive/`-rad i .gitignore — `grep -ri "tags:.*lockfile" .archive/` hämtade den medan baslinjen inte hade något index att gå igenom. Dokumentationen sänktes en poäng: README:s Quick Install leder med /plugin marketplace add, yet archive is absent from .claude-plugin/marketplace.json and ships .factory-plugin/plugin.json instead, so the plugin route and its automatic hook registration do not work in Claude Code.

Testad: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

# Recommended (works with Claude Code, Cursor, Droid, Codex):
npx skills add ReScienceLab/opc-skills --skill archive -a claude   # user-level
npx skills add ReScienceLab/opc-skills --skill archive              # project-level

# Manual (no npx):
git clone --depth 1 https://github.com/ReScienceLab/opc-skills /tmp/opc-skills
mkdir -p ~/.claude/skills
cp -R /tmp/opc-skills/skills/archive ~/.claude/skills/archive

# Optional SessionStart auto-load of .archive/MEMORY.md: register
# ~/.claude/skills/archive/hooks/load-memory.py as a SessionStart command hook
# in settings.json. Note `/plugin install archive@opc-skills` does NOT resolve —
# archive is missing from the repo's .claude-plugin/marketplace.json.

# First use: add `.archive/` to your project .gitignore (the skill requires this).

Kommandon och exempelprompter

/archiveSkriver sessionslärdomar till .archive/ÅÅÅÅ-MM-DD/ med taggad frontmatter och ett MEMORY.md-index

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

Archive this session's learnings for later reuse
Save this debugging solution for later reuse
Log this deployment in the archive

Läs hela rapporten →