Skip to content

v0.1.8 - SKILL-MINE mode

Choose a tag to compare

@cskwork cskwork released this 05 Jun 14:27
· 43 commits to main since this release
7373ad7

v0.1.8 — SKILL-MINE mode

A seventh mode for turning your repeated work into a reusable skill. Trigger it with "make a skill", "스킬 만들어", "learn new skill", "make skill from history", or "이거 자주 하는데 스킬로".

It mines your recent agent session history (~/.claude/projects/*.jsonl, adaptive 7-30 day window), surfaces 3-5 candidate skills ranked by frequency × payoff, and lets you pick / reject / name a new one. On your pick it forges ONE cross-agent-portable SKILL.md (the agentskills.io open standard) and installs it. The human pick is a hard gate — it never creates or installs a skill you did not approve (the validation step that Hermes-style autonomous skill creation lacks). It writes no production code and no worktree.

Highlights

  • Pipeline: Intake → Window → Mine → Rank → Suggest → Human pick/reject → Forge → Verify → Install → Journal. No worktree, no delivery gate.
  • Mechanical miner (templates/skill-mine/mine.mjs, pure Node, no deps): reads the full tool-call transcripts (not the prompt-only history.jsonl), picks an adaptive window, and emits frequent Bash command signatures + first-prompt intent clusters + already-used skills. A real-data experiment confirmed raw tool-name n-grams are generic noise; the signal lives in command signatures and intent clusters.
  • Portable forge: generates a directory + SKILL.md to the agentskills.io standard. A frontmatter gate (templates/skill-frontmatter-gate.mjs) enforces the portable limits — name lowercase/≤64/no reserved word, description+when_to_use ≤1536 chars, body ≤~5k tokens.
  • Cross-agent install, no auto-sync: one canonical real dir (e.g. ~/.agents/skills/<name>/) symlinked into each agent (Claude Code / Codex / opencode / Hermes), so one edit lands everywhere. Every run ends by stating where the source skill lives.
  • Anti over-suggestion gate: surface a candidate only when frequency ≥ minsup AND it plausibly recurs (Horvitz mixed-initiative); rejection is free and ends the run.

Wiring & tests

New files: reference/skill-mine.md, templates/skill-mine/mine.mjs, templates/skill-frontmatter-gate.mjs, templates/skill.md.template, agents/skill-miner.md, agents/skill-forger.md. Wired into SKILL / Step 0 routing / reference map / template scripts; README + landing updated to 7 modes.

Frontmatter gate: 5/5 (valid passes; uppercase name, empty description, combined >1536, missing SKILL.md each fail). Miner verified on real history (7d, 19 sessions, 1290 tool-calls), sparse-history widen-to-30d, and --all (850 sessions). Dogfooded end-to-end — forged 4 real skills (gh-release, sync-skill, refine-skill-terse, update-gh-pages) installed across 4 agents.

Full rationale: log/changelog-2026-06-05.md.

Full changelog: v0.1.7...v0.1.8