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

Agent	Support level	Recommended path
Codex	Native Agent Skills, plus optional plugin metadata.	~/.codex/skills/ or .agents/skills/
Claude Code	Native skills in personal, project, and plugin scopes.	~/.claude/skills/ or .claude/skills/
Cursor	Native Agent Skills and rules/commands; skills are discoverable by Agent.	.agents/skills/, .cursor/skills/, or global skills
OpenCode	Native skill tool and repo/home skill discovery.	.agents/skills/, .opencode/skills/, or ~/.config/opencode/skills/
Gemini CLI / Google agents	Agent Skills open format is documented by Google; GEMINI.md remains the always-on context mechanism.	.agents/skills/ or installer-managed skills

The safest public layout is skills/<name>/SKILL.md in the repo plus install instructions that copy into .agents/skills/ or the target agent's native skill directory.

Usage

Ask for the direction you want:

Mine my coding-agent history and find repeated workflows that should become skills.

---

GitHub에서 전체 내용 보기