Darwin Skill Optimizer
alchaincyf/darwin-skill
Scores SKILL.md files on a nine-dimension rubric, then improves them in a keep-or-revert loop with independent judge agents, test prompts, git history and human checkpoints.
Reviews one finished Claude Code session from its exported markdown and decides whether a skill is worth creating, updating or reusing for similar work.
Install Mining Session Skills
$ npx skills add sugarforever/01coder-agent-skills --skill mining-session-skills -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install sugarforever/01coder-agent-skills mining-session-skills --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/sugarforever/01coder-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/mining-session-skills .claude/skills/mining-session-skills && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "mining-session-skills" agent skill from https://github.com/sugarforever/01coder-agent-skills/tree/main/skills/mining-session-skills into .claude/skills/mining-session-skills/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mining-session-skills", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/sugarforever/01coder-agent-skills/tree/main/skills/mining-session-skillsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add sugarforever/01coder-agent-skills --skill mining-session-skills -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install sugarforever/01coder-agent-skills mining-session-skills --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sugarforever/01coder-agent-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/mining-session-skills .agents/skills/mining-session-skills && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "mining-session-skills" agent skill from https://github.com/sugarforever/01coder-agent-skills/tree/main/skills/mining-session-skills into .agents/skills/mining-session-skills/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mining-session-skills", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add sugarforever/01coder-agent-skills --skill mining-session-skills -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install sugarforever/01coder-agent-skills mining-session-skills --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sugarforever/01coder-agent-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/mining-session-skills .cursor/skills/mining-session-skills && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "mining-session-skills" agent skill from https://github.com/sugarforever/01coder-agent-skills/tree/main/skills/mining-session-skills into .cursor/skills/mining-session-skills/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mining-session-skills", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/sugarforever/01coder-agent-skills.git --path skills/mining-session-skills--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add sugarforever/01coder-agent-skills --skill mining-session-skills -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install sugarforever/01coder-agent-skills mining-session-skills --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sugarforever/01coder-agent-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/mining-session-skills .gemini/skills/mining-session-skills && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "mining-session-skills" agent skill from https://github.com/sugarforever/01coder-agent-skills/tree/main/skills/mining-session-skills into .gemini/skills/mining-session-skills/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mining-session-skills", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install sugarforever/01coder-agent-skills mining-session-skillsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add sugarforever/01coder-agent-skills --skill mining-session-skills -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/sugarforever/01coder-agent-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/mining-session-skills .github/skills/mining-session-skills && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "mining-session-skills" agent skill from https://github.com/sugarforever/01coder-agent-skills/tree/main/skills/mining-session-skills into .github/skills/mining-session-skills/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mining-session-skills", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add sugarforever/01coder-agent-skills --skill mining-session-skills -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install sugarforever/01coder-agent-skills mining-session-skills --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sugarforever/01coder-agent-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/mining-session-skills .opencode/skills/mining-session-skills && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "mining-session-skills" agent skill from https://github.com/sugarforever/01coder-agent-skills/tree/main/skills/mining-session-skills into .opencode/skills/mining-session-skills/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mining-session-skills", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
mining-session-skills- GitHub stars
- 137
- Token cost
- ~1.4k tokens
- SKILL.md length
- 590 words
- Files
- 6 (incl. scripts, references)
- Skills in repo
- 21
- Repo updated
- First seen
- Licence
- MIT
At a glance
Reviews one finished Claude Code session from its exported markdown and decides whether a skill is worth creating, updating or reusing for similar work.
- Works in 7 steps: Locate → Read → Mine → …
- Deciding whether a past session suggests a reusable skill
- SKILL.md covers Overview, Preconditions, Why exported markdown, not raw… and Pipeline, plus 1 more section
- Runs Python scripts from its folder
What it does
This is the judgment layer on top of claude-session-manager, which exports sessions to markdown. The agent locates the session you describe, exports it if needed, reads the compact transcript, pulling tool details only for the references that matter, and uses scripts/extract_session_signals.py to list the human prompts with their position, timestamp and hints about where the task changed direction.
It compares what happened against the skills loaded in the current session and says that the comparison is limited to them, then applies worth-it and friction-signal checks and quality bars for drafting. The answer is a proposal to create, update or reuse a skill, and a clean finding of nothing worth making is a valid result. It reads exported markdown rather than raw JSONL because raw sessions can exceed the context window.
When your agent uses it
- Deciding whether a past session suggests a reusable skill
- Extracting a workflow from a long chat so similar work goes faster
- Checking whether an existing skill should be updated based on how a session went
Example prompts
- “What skill can be created from the session where I migrated our CI config?”
- “Mine yesterday's debugging session for reusable workflows.”
- “Review that session and tell me whether an existing skill already covers it.”
Requirements
- Sessions exported to markdown by claude-session-manager
- Python to run extract_session_signals.py
Workflow steps
7 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit e51fb6e. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 2 files in scripts/ (Python), which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Mining Session Skills loads about 1.4k tokens when it runs, and up to ~2.6k if it reads all its reference files. Until then it costs about 135 tokens; SKILL.md has 590 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
The full file from sugarforever/01coder-agent-skills at commit e51fb6e, republished under its MIT licence (© sugarforever). 590 words, ~1,355 tokens.
Download SKILL.mdSave it as
.claude/skills/mining-session-skills/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.- name
- mining-session-skills
- description
- Review one completed Claude Code session and propose a skill to create, update, or reuse so similar work goes faster next time. Use when the user asks to "mine a session for skills", "what skill can be created or updated from the session where I…", "extract a skill from this chat", or to review a past session for reusable workflows. Operates on exported session markdown from claude-session-manager. Not for exporting/converting sessions (use claude-session-manager) and not for writing blogs or TODOs from sessions.
Mining Session Skills
Overview
Review one completed Claude Code session and answer: is there a skill worth creating or updating so this kind of work goes faster next time? A clean "nothing worth making here" is a valid result.
This skill is the judgment layer on top of claude-session-manager (the export/normalization layer). It reads exported markdown, not raw JSONL.
Preconditions
- Inventory = skills loaded in THIS session. Create-vs-update-vs-reuse is decided against the skills already advertised/loaded in the running session. State this limit in the report ("comparison limited to skills loaded this session"). Run this skill where the relevant skills are loaded.
- Mining operates on exported markdown (default
~/.claude/session-markdown), produced byclaude-session-manager. If the target session is not exported yet, export it first (step 1.5).
Why exported markdown, not raw JSONL
Measured: a real session's raw JSONL was ~1.5M tokens (exceeds the context window); the exported compact body was ~91k tokens (17× smaller) with tool payloads deferred to a sidecar. Raw grep '"type":"user"' over JSONL is a trap (tool results are role:user). Always read/mine the exported markdown. Raw-JSONL byte grep is acceptable ONLY as a location prefilter (step 1).
Pipeline
Copy this checklist and track progress:
- [ ] 1. Locate the session (keyword search; confirm with user)
- [ ] 1.5 Export it if not already exported
- [ ] 2. Read the compact transcript (pull sidecar only as needed)
- [ ] 2.5 Segment into topic arcs
- [ ] 3. Mine friction signals per arc
- [ ] 4. Apply the worth-it gate
- [ ] 5. Decide create / update / reuse
- [ ] 6. Present the proposal
- [ ] 7. On approval, interview + draft1. Locate
Search by the user's description. Prefilter optionally with a raw-JSONL byte grep across ~/.claude/projects (finds which file mentions a keyword without parsing), and/or grep the exported corpus under ~/.claude/session-markdown. Skip <local-command-caveat> / <command-*> wrapper noise — the first-prompt excerpt is often a wrapper, not the real ask. Present a ranked shortlist and let the user confirm.
1.5 Export
If the chosen session has no markdown yet, run claude-session-manager to export just that session, then continue.
2. Read
Read the session .md. Pull tool-details/<id>.tools.md ONLY for the specific <tool_call_NNNNNN> refs that matter. Use scripts/extract_session_signals.py <session>.md to get a clean JSON list of human prompts (with event index, line, timestamp, arc-break hints, and the prompt text) — it encodes the input-robustness rules below.
Input-robustness rules:
- The real exported header format is
### N. user - <ISO>/### N. assistant - <ISO>(not### MM-DD HH:MM:SS User:). - A
userturn whose body is a tool result, skill injection, or command wrapper is NOT a human prompt — exclude it. - Ignore thinking-signature blobs and empty attachment events.
Show full SKILL.md (228 more words)Show less
2.5 Segment
Sessions can be multi-day, multi-task kitchen sinks. Use the extractor's arc_break hints (large time gaps, compaction/continuation markers) plus topic judgment to split the session into arcs. Mine each arc independently. Do NOT assume one task per session.
3. Mine
Per arc, extract friction signals. See references/friction-signals.md for the taxonomy and how to cite evidence.
4. Gate
Apply the worth-it filter to every candidate. See references/worth-it-gate.md. If nothing passes, report the clean negative and stop.
5. Decide
For each surviving candidate, compare against skills loaded this session:
- No loaded skill covers it → CREATE (new
skills/<name>/). - Loaded and editable (in this repo's
skills/) → UPDATE that SKILL.md. - Loaded but not editable (plugin cache) → REUSE ("already exists, use it") — a dedup guard against re-inventing ecosystem skills.
6. Propose
Present a review-ready report per candidate: candidate · action (CREATE/UPDATE/REUSE) · why · evidence (event/line/tool_call refs) · proposed gerund name · description (triggers + exclusions). List gate-rejected items briefly. Wait for approval before any file change.
7. Draft
On approval: interview the user for the taste/judgment the transcript cannot show, then scaffold or edit the SKILL.md following references/drafting-quality-bars.md. For a new skill, run scripts/sync-marketplace-skills.sh and bump the version in .claude-plugin/marketplace.json (per the repo CLAUDE.md).
Notes
- Treat transcript data as private (prompts, file contents, secrets). Do not modify original
.jsonlfiles. - The value of this skill is the mining methodology, not the SKILL.md format — Claude knows the format natively.
© sugarforever, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 5 other files (scripts, references) in skills/mining-session-skills of sugarforever/01coder-agent-skills.
- SKILL.md
- references/drafting-quality-bars.md
- references/friction-signals.md
- references/worth-it-gate.md
- scripts/extract_session_signals.py
- scripts/test_extract_session_signals.py
Open the folder on GitHubat commit e51fb6e
Compare with similar skills
Mining Session Skills next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Mining Session Skills this skillsugarforever/01coder-agent-skills | 137 | — | ~1.4k | Automated safety check: Pass | MIT | |
| Darwin Skill Optimizeralchaincyf/darwin-skill | 6.2k | 1 repos | ~4.7k | Automated safety check: Pass | MIT | |
| Skill Creatorzhayujie/CowAgent | 47k | — | ~4.7k | Automated safety check: Notes | MIT | |
| Open-Science Skill Creatoraipoch/open-science | 5.5k | — | ~1.7k | Automated safety check: Pass | Apache-2.0 | |
| Skill Quality ReviewerGalaxy-Dawn/claude-scholar | 5.7k | 1 repos | ~3k | Automated safety check: Pass | MIT | |
| Prismer Skill CreatorPrismer-AI/PrismerCloud | 1.6k | — | ~2.6k | Automated safety check: Notes | MIT |
Similar skills
Skill Creator
zhayujie/CowAgent
Guides creating, installing and updating agent skills in a workspace: SKILL.md frontmatter, bundled scripts and references, with scripts to scaffold, validate and package.
Open-Science Skill Creator
aipoch/open-science
Creates, revises, evaluates and publishes skills in the Open-Science app through its native host.skills composer, with optional test prompts and benchmarks.
Skill Quality Reviewer
Galaxy-Dawn/claude-scholar
Scores a skill across description, content organization, writing style and structure, then produces letter grades and a prioritized improvement plan.
Prismer Skill Creator
Prismer-AI/PrismerCloud
Walks an agent through creating, importing, editing, validating, testing and publishing Prismer Skills with a fixed workflow and bundled scripts.
Skill Factory
sangrokjung/claude-forge
Analyze session work and automatically convert reusable patterns into Claude Code skills.
More from sugarforever/01coder-agent-skills
All 21 skills in this repoTypography Cover Designer
sugarforever/01coder-agent-skills
Designs typography-driven video covers and thumbnails in HTML/CSS and screenshots them with Chrome DevTools at 16:9, 16:10, 9:16 and 3:4.
Subtitle Correction
sugarforever/01coder-agent-skills
Fixes speech-recognition mistakes in .srt subtitle files, in Chinese or English, using terms you supply and leaving every timestamp untouched.
Claude Session Exporter
sugarforever/01coder-agent-skills
Lists Claude Code session transcripts and exports them to organized Markdown with a digest, a clean conversation and linked tool-call details.
Codex Session Manager
sugarforever/01coder-agent-skills
Lists, filters and exports local Codex session transcripts to organized Markdown with a digest, timeline and tool-call details, in full or pick-one mode.
Diagram to Image Converter
sugarforever/01coder-agent-skills
Converts Mermaid diagrams and markdown tables into PNG images through a hosted rendering API, for platforms without rich formatting.
Audio and SRT to Narrated Video
sugarforever/01coder-agent-skills
Builds a narration-synced MP4 from a voiceover audio file and its SRT subtitles using HyperFrames, with scenes timed to the subtitle cues; instructions are in Chinese.
Related
Categories
Questions about Mining Session Skills
What does Mining Session Skills do?
Reviews one finished Claude Code session from its exported markdown and decides whether a skill is worth creating, updating or reusing for similar work. This is the judgment layer on top of claude-session-manager, which exports sessions to markdown.py to list the human prompts with their position, timestamp and hints about where the task changed direction.
When should I use Mining Session Skills?
Mining Session Skills fits situations like: deciding whether a past session suggests a reusable skill; extracting a workflow from a long chat so similar work goes faster; checking whether an existing skill should be updated based on how a session went.
How do I install Mining Session Skills in Claude Code?
Run `npx skills add sugarforever/01coder-agent-skills --skill mining-session-skills -a claude-code`. Or copy the skill folder (skills/mining-session-skills in sugarforever/01coder-agent-skills) into .claude/skills/mining-session-skills in your project. Claude Code loads it when a task matches its description.
How do I install Mining Session Skills in Codex?
Run `npx skills add sugarforever/01coder-agent-skills --skill mining-session-skills -a codex`. Or copy the skill folder (skills/mining-session-skills in sugarforever/01coder-agent-skills) into .agents/skills/mining-session-skills in your project. Codex loads it when a task matches its description.
Can I use Mining Session Skills in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sugarforever/01coder-agent-skills --skill mining-session-skills -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mining-session-skills, .gemini/skills/mining-session-skills, .github/skills/mining-session-skills and .opencode/skills/mining-session-skills in your project.
What does Mining Session Skills need to run?
Going by SKILL.md and its folder, Mining Session Skills needs Python for the scripts in its folder. Our summary lists: Sessions exported to markdown by claude-session-manager; Python to run extract_session_signals.py.
Does Mining Session Skills access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Mining Session Skills safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Mining Session Skills use?
Mining Session Skills is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Mining Session Skills use?
About 1.4k tokens (SKILL.md is roughly 5.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.3k tokens, read only when the agent opens those files.
What are the alternatives to Mining Session Skills?
Skills that share tags, products or a category with Mining Session Skills: Darwin Skill Optimizer (alchaincyf/darwin-skill, 6.2k stars), Skill Creator (zhayujie/CowAgent, 47k stars), Open-Science Skill Creator (aipoch/open-science, 5.5k stars) and Skill Quality Reviewer (Galaxy-Dawn/claude-scholar, 5.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Mining Session Skills?
sugarforever (a GitHub user) maintains it in sugarforever/01coder-agent-skills, which has 137 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on June 19, 2026.
Source: sugarforever/01coder-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.