Skip to content

Skill Optimizer

Agent Skills lifecycle toolkit: mine repeated coding-agent workflows, audit and personalize skills, and generalize personal skills for public release.

Install

$git clone https://github.com/hqhq1025/skill-optimizer

Install command taken from the project's README or registry entry. Always review code before running it.

Skill Optimizer

中文版

Three Agent Skills for turning coding-agent work into better SKILL.md files:

  • skill-miner — mine coding-agent history, archives, memories, and repeated work to surface skill-worthy workflows with evidence.
  • skill-personalizer — audit and adapt newly created, downloaded, forked, or community skills to one user's own tools, habits, directories, and session history.
  • skill-generalizer — turn local, private, personal skills into publishable skills for GitHub, marketplaces, teams, or public sharing.

Current release: v2.0.0. This is a major redesign from the original single-skill optimizer.

Project site: https://hqhq1025.github.io/skill-optimizer/

The split is intentional. Generating, personalizing, and publishing skills are different jobs:

Goal Skill Optimization Direction
Mine repeated workflows skill-miner Scan real agent usage, cluster repeated workflows, and draft evidence-backed candidate skills.
Fit inward skill-personalizer Preserve the original optimizer's audit checks, then add local defaults, user phrasing, preferred tools, verification habits, and workflow shortcuts.
Publish outward skill-generalizer Remove private context, generalize examples, make install and README claims portable.

See Research Background for related agent-skill ecosystems, comparable projects, and papers that motivate session mining, skill libraries, trigger auditing, progressive disclosure, and lifecycle governance.

Installation

Copy the command below into your agent's chat:

Claude Code

Install the skills from https://github.com/hqhq1025/skill-optimizer

Codex

Install the skills from https://github.com/hqhq1025/skill-optimizer into ~/.codex/skills/

Other Agent Skills-compatible agents

Install the skills from https://github.com/hqhq1025/skill-optimizer into ~/.agents/skills/

Manual install:

git clone https://github.com/hqhq1025/skill-optimizer.git /tmp/skill-optimizer
mkdir -p ~/.agents/skills
cp -r /tmp/skill-optimizer/skills/skill-miner ~/.agents/skills/
cp -r /tmp/skill-optimizer/skills/skill-personalizer ~/.agents/skills/
cp -r /tmp/skill-optimizer/skills/skill-generalizer ~/.agents/skills/
rm -rf /tmp/skill-optimizer

For Codex-only installs, use ~/.codex/skills/:

git clone https://github.com/hqhq1025/skill-optimizer.git /tmp/skill-optimizer
mkdir -p ~/.codex/skills
cp -r /tmp/skill-optimizer/skills/skill-generalizer ~/.codex/skills/
cp -r /tmp/skill-optimizer/skills/skill-miner ~/.codex/skills/
cp -r /tmp/skill-optimizer/skills/skill-personalizer ~/.codex/skills/
rm -rf /tmp/skill-optimizer

For Claude Code-only installs, use ~/.claude/skills/.

Platform Support

Similar plugs

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local…

Why use many token when few token do trick. Viral skill + proxy for coding agents that cuts 65% of tokens by talking like a caveman.

The 1st Collaborative AI Design Agent Workspace. Local-first and open source. Create prototypes, websites, apps, dashboards, presentations, images, and videos with your team…

Explore related