Agent skill

Skill Miner

by hqhq1025 in hqhq1025/skill-optimizer

A skill your agent uses when mining coding-agent session history, archived transcripts, memories, or repeated local work to discover recurring workflows that should become new Agent Skills.

MITAuto-check passedAgent Workflows

Install Skill Miner

skills CLI
$ npx skills add hqhq1025/skill-optimizer --skill skill-miner -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hqhq1025/skill-optimizer skill-miner --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hqhq1025/skill-optimizer.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/skill-miner .claude/skills/skill-miner && rm -rf skills-src

Use ~/.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/

Facts

Skill name
skill-miner
GitHub stars
181
Token cost
~719 tokens
SKILL.md length
365 words
Files
5 (incl. scripts, references)
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when mining coding-agent session history, archived transcripts, memories, or repeated local work to discover recurring workflows that should become new Agent Skills.

  • Works in 8 steps: Locate real evidence: session JSONL,… → Run scripts/scan_sessions.py for a… → Cluster repeated work by intent, trigger… → …
  • Mining coding-agent session history
  • SKILL.md covers Overview, When To Use, Workflow and Evidence Rules, plus 1 more section
  • Runs Python scripts from its folder

What it does

Skill Miner is an agent skill from hqhq1025/skill-optimizer. Use when mining coding-agent session history, archived transcripts, memories, or repeated local work to discover recurring workflows that should become new Agent Skills.

Its SKILL.md is about 720 tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/discovery-rubric.md` and `references/patterns.json`).

It sits in Agent Workflows, covering AI search optimization and Skill management. It works with GitHub. The repository describes itself as: Agent Skills lifecycle toolkit: mine repeated coding-agent workflows, audit and personalize skills, and generalize personal skills for public release. The licence is MIT.

When your agent uses it

  • Mining coding-agent session history
  • Archived transcripts
  • Repeated local work to discover recurring workflows that should become new Agent Skills

Example prompts

  • “/skill-miner”

Requirements

  • Python 3

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Locate real evidence: session JSONL, memory summaries, repo notes, repeated scripts, and recent project folders.
  2. Run scripts/scan_sessions.py for a first-pass sanitized cluster report when local session files or exported transcripts are available.
  3. Cluster repeated work by intent, trigger phrasing, tools used, files touched, and verification pattern.
  4. Filter out one-off tasks, ordinary coding knowledge, and project-specific instructions better suited for AGENTS.md.
  5. Score candidates by recurrence, friction, risk, portability, and future value.
  6. For each strong candidate, draft a concise skill name, trigger description, workflow outline, bundled-resource needs, and validation…
  7. Recommend whether each candidate should stay personal, become a public skill via skill-generalizer, or be skipped.
  8. If the user asks to proceed, create the selected skill folders and verify frontmatter/layout.

What it can do on your machine

Read from SKILL.md and the folder at commit b9ffd15. 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 1 file 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

Skill Miner loads about 719 tokens when it runs, and up to ~2.9k if it reads all its reference files. Until then it costs about 45 tokens; SKILL.md has 365 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~45
When it runs · the whole SKILL.md, loaded when a task matches
~719
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.9k

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 hqhq1025/skill-optimizer at commit b9ffd15, republished under its MIT licence (© hqhq1025). 365 words, ~719 tokens.

Download SKILL.mdSave it as .claude/skills/skill-miner/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
skill-miner
description
Use when mining coding-agent session history, archived transcripts, memories, or repeated local work to discover recurring workflows that should become new Agent Skills.

Skill Miner

Overview

Mine real agent usage for new skill opportunities. The goal is to find repeated workflows, extract the reusable technique, and turn strong candidates into draft skills with evidence.

When To Use

  • A user wants to scan past coding-agent sessions for repeated workflows.
  • The user suspects they keep asking agents to do similar tasks manually.
  • A team wants a backlog of candidate skills based on actual work rather than brainstorming.
  • Existing memories, session logs, or project notes contain recurring procedures that have not been packaged.

Do not use to tune an existing skill; use skill-personalizer. Do not use to publish a private skill publicly; use skill-generalizer.

Workflow

  1. Locate real evidence: session JSONL, memory summaries, repo notes, repeated scripts, and recent project folders.
  2. Run scripts/scan_sessions.py for a first-pass sanitized cluster report when local session files or exported transcripts are available.
  3. Cluster repeated work by intent, trigger phrasing, tools used, files touched, and verification pattern.
  4. Filter out one-off tasks, ordinary coding knowledge, and project-specific instructions better suited for AGENTS.md.
  5. Score candidates by recurrence, friction, risk, portability, and future value.
  6. For each strong candidate, draft a concise skill name, trigger description, workflow outline, bundled-resource needs, and validation prompts.
  7. Recommend whether each candidate should stay personal, become a public skill via skill-generalizer, or be skipped.
  8. If the user asks to proceed, create the selected skill folders and verify frontmatter/layout.
Show full SKILL.md (130 more words)Show less

Evidence Rules

  • Quote or summarize enough source evidence to justify each candidate.
  • Do not expose sensitive transcript content unless the user explicitly asks for raw evidence.
  • Avoid turning every repeated task into a skill; prefer workflows where guidance changes future behavior.
  • Treat broad intent clusters as navigation hints, not skill drafts.
  • Check sampled positives and near misses before trusting a regex-based workflow candidate.
  • If session access is incomplete, label findings as partial and list what was scanned.

References

Read discovery-rubric.md before doing a full session-history scan or creating candidate skill drafts.

Use scripts/scan_sessions.py --help for the deterministic scanner. It supports native Codex/Claude/Gemini-style local evidence, --export inputs for other agents, and --patterns for personalized workflow definitions. Treat its output as evidence for review, not as an automatic decision to create skills.

© hqhq1025, 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 4 other files (scripts, references) in skills/skill-miner of hqhq1025/skill-optimizer.

  • SKILL.md
  • agents/openai.yaml
  • references/discovery-rubric.md
  • references/patterns.json
  • scripts/scan_sessions.py

Open the folder on GitHubat commit b9ffd15

Compare with similar skills

Skill Miner 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 Miner compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skill Miner this skillhqhq1025/skill-optimizer181—~719Automated safety check: PassMIT
TeamAI Setup and LifecycleTencent/teamai-cli5.2k—~1.2kAutomated safety check: PassCustom licence
Dotagentsgetsentry/sentry-wizard295—~900Automated safety check: PassCustom licence
Skill Base CLIginuim/skill-base121—~1.9kAutomated safety check: PassNone
Octocode Skills Managerbgauryy/octocode949—~1.2kAutomated safety check: PassMIT
Skill ManagerLiangNiang/OpenMantis110—~459Automated safety check: PassApache-2.0

Similar skills

  • TeamAI Setup and Lifecycle

    Tencent/teamai-cli

    Walks a non-technical user through creating or joining a TeamAI team repo, then managing members, roles, MCP, and environment settings.

    5.2k GitHub stars~1.2k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Dotagents

    getsentry/sentry-wizard

    Official

    Manage agent skill dependencies with dotagents. An agent skill from getsentry/sentry-wizard.

    295 GitHub stars~900 tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed
  • Skill Base CLI

    ginuim/skill-base

    Uses the skb command to search, install, update, delete, publish and import skills on a Skill Base site, including curated collections and GitHub imports.

    121 GitHub stars~1.9k tokensUpdated 19 days ago
    Agent WorkflowsAuto-check passed
  • Octocode Skills Manager

    bgauryy/octocode

    Finds, rates, reviews, creates, improves, installs and syncs Agent Skill folders from local workspaces, registries or remote sources, with a user gate before any write.

    949 GitHub stars~1.2k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Skill Manager

    LiangNiang/OpenMantis

    管理 OpenMantis 技能的全生命周期。创建、发现、安装、审核、更新技能。当用户说"创建 skill"、"做个技能"、"find a skill"、"有没有 XX skill"、"审核 skill"、"检查兼容性"、"更新 skill"、"修改 skill"、"turn this into a skill"时触发。当用户发送 GitHub 链接或 skill 包链接时也应触发(下载+审核)。

    110 GitHub stars~459 tokensUpdated 4 mo ago
    Agent WorkflowsAuto-check passed
  • Install a skill from a public GitHub repository onto this device.

    241 GitHub stars~1.2k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from hqhq1025/skill-optimizer

  • Skill Generalizer

    hqhq1025/skill-optimizer

    A skill your agent uses when turning local, private, or personal Agent Skills into publishable skills for GitHub, marketplaces, teams, or public sharing, especially when private paths, personal…

    181 GitHub stars~641 tokensUpdated 5 mo ago
    Auto-check passed
  • Skill Personalizer

    hqhq1025/skill-optimizer

    A skill your agent uses when auditing or adapting newly created, downloaded, forked, installed, or community Agent Skills to the user's tools, habits, directories, session history, and preferred…

    181 GitHub stars~630 tokensUpdated 5 mo ago
    Auto-check passed

Works with

Questions about Skill Miner

What does Skill Miner do?

A skill your agent uses when mining coding-agent session history, archived transcripts, memories, or repeated local work to discover recurring workflows that should become new Agent Skills. Skill Miner is an agent skill from hqhq1025/skill-optimizer. Use when mining coding-agent session history, archived transcripts, memories, or repeated local work to discover recurring workflows that should become new Agent Skills.

When should I use Skill Miner?

Skill Miner fits situations like: mining coding-agent session history; archived transcripts; repeated local work to discover recurring workflows that should become new Agent Skills.

How do I install Skill Miner in Claude Code?

Run `npx skills add hqhq1025/skill-optimizer --skill skill-miner -a claude-code`. Or copy the skill folder (skills/skill-miner in hqhq1025/skill-optimizer) into .claude/skills/skill-miner in your project. Claude Code loads it when a task matches its description.

How do I install Skill Miner in Codex?

Run `npx skills add hqhq1025/skill-optimizer --skill skill-miner -a codex`. Or copy the skill folder (skills/skill-miner in hqhq1025/skill-optimizer) into .agents/skills/skill-miner in your project. Codex loads it when a task matches its description.

Can I use Skill Miner 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 hqhq1025/skill-optimizer --skill skill-miner -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skill-miner, .gemini/skills/skill-miner, .github/skills/skill-miner and .opencode/skills/skill-miner in your project.

What does Skill Miner need to run?

Going by SKILL.md and its folder, Skill Miner needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Skill Miner 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 Skill Miner 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 Skill Miner use?

Skill Miner 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 Skill Miner use?

About 719 tokens (SKILL.md is roughly 2.9k 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 2.1k tokens, read only when the agent opens those files.

What are the alternatives to Skill Miner?

Skills that share tags, products or a category with Skill Miner: TeamAI Setup and Lifecycle (Tencent/teamai-cli, 5.2k stars), Dotagents (getsentry/sentry-wizard, 295 stars), Skill Base CLI (ginuim/skill-base, 121 stars) and Octocode Skills Manager (bgauryy/octocode, 949 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Skill Miner?

hqhq1025 (a GitHub user) maintains it in hqhq1025/skill-optimizer, which has 181 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on May 14, 2026.

Source: hqhq1025/skill-optimizer on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.