Memory

skillminer

Suggest reusable skills from recurring patterns in local memory files. Human review gate, drafts only to skills/_pending/, local-first runner with optional external fallback. Triggers on "skill forge", "propose a skill", "what skills should I have", "skill candidates", "what patterns have I been doing", "forge me a skill", "forge show", "forge accept", "forge reject", "forge promote".

What it does

The skill document

skillminer ⚒️

Your AI assistant keeps solving the same problems. skillminer notices and suggests turning them into reusable skills.

skillminer watches your local memory files, spots recurring work, and surfaces the patterns worth keeping. No auto-activation, no cloud sync, no noise by default. A morning suggestion in your inbox when something actually deserves to become a skill.

Trust model

Human gate first, always. Nothing ships without your explicit accept.
Drafts go to skills/_pending//, never to live skills.
Default runner is local OpenClaw. No data leaves the host.
FORGE_RUNNER=claude is an opt-in external fallback that sends prompt data to Anthropic's API.
Notifications are off by default; review files are written locally regardless.

Flow

nightly scan   reads recent memory/YYYY-MM-DD.md files
               detects recurring task patterns
               writes a review file to state/review/
               ↓
YOU DECIDE     forge accept / reject / defer / silence
               ↓
morning write  drafts a SKILL.md into skills/_pending//
               you review it, promote it, ship it

Nothing goes live automatically. You stay in control at every step.

Quick start

openclaw skills install skillminer
cd "${CLAWD_DIR:-$HOME/clawd}/skills/skillminer"
bash setup.sh
CLAWD_DIR="${CLAWD_DIR:-$HOME/clawd}" bash scripts/run-nightly-scan.sh

If the manual scan looks good, add the printed scheduler jobs using the dispatcher prompts.

Environment

CLAWD_DIR — optional, defaults to ~/clawd
FORGE_RUNNER — defaults to openclaw (local). Set to claude only if you accept that prompt data leaves the host.

Commands

forge is the command prefix.

forge show — list current candidates
forge review — open the latest review file
forge accept — accept a candidate for the next morning write
forge reject "reason" — reject permanently
forge defer "reason" — defer with cooldown
forge silence "reason" — silence without cooldown
forge unsilence — resurface a silenced entry
forge promote — move a pending draft into live skills

Manual triggers

When you want a one-shot run without remembering full paths:

skillminer scan     # run nightly scan now
skillminer write    # run morning write now
skillminer full     # scan + write in sequence
skillminer status   # show current ledger state
skillminer help     # show usage

Security

Slug validation gates every filesystem-path boundary (regex-enforced)
Atomic state writes with backup rotation and JSON validation
flock-based single-instance guarantee across all entry points
Memory files are treated as untrusted data in the nightly scan prompt

See README.md and USER_GUIDE.md for full docs.

Related skills

Skill Recommender

Agent skill recommender. Input a user need, task description, or existing skill list; output best matching skills, install rationale, duplicate/merge candida...

37 installs

anything-to-skill

Convert a book, paper, document, documentation site, or code repository into a structured, on-demand agent skill. Use when the user wants to turn a PDF, EPUB, DOCX, a URL, a docs site, or a GitHub repo into a skill they can load later — "make a skill from this book", "turn this paper into a skill", "turn these docs into a skill", "I want an agent that knows this library".

3 installs

skill-kit

Claude Code skill management. Topics — writer (create), lint (validate + fix frontmatter), merge (combine related), dedup (find duplicates), convert (agent → skill), architecture (multi-topic structure), upgrade (enhance + add topics), route (topic placement), trigger (declare + auto-register hooks), find (discover via npx skills CLI), graph (extract depends-on + topic body Skill calls into Edge Table + Mermaid + dispatched d3 force-directed render), language (per-skill language consistency enforcement), portability (public skill cross-ref + vendor isolation), publish-scope (published skill scope review before extending), invoke-discipline (slash command → Skill tool call, multi-topic Read, post-decision auto-invoke, interactive script, vendor dispatch). Use when: "skill writer", "skill lint", "skill merge", "skill dedup", "create skill", "frontmatter fix", "multi-topic skill", "convert agent", "skill upgrade", "add topic", "topic route", "trigger compile", "hook auto register", "find

24 installs