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-optimizerInstall command taken from the project's README or registry entry. Always review code before running it.
README excerpt
Read full README on GitHub →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
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
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.
Production-grade engineering skills for AI coding agents.
The 1st Collaborative AI Design Agent Workspace. Local-first and open source. Create prototypes, websites, apps, dashboards, presentations, images, and videos with your team…