⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
skill-generalizer
Use when turning local, private, or personal Agent Skills into publishable skills for GitHub, marketplaces, teams, or public sharing, especially when private paths, personal habits, credentials, internal hosts, or user-specific context must be removed.
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
Not yet listed on ClawHub or SkillsMP
// README
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.
Audit and tune my installed skills; tell me which ones are undertriggering, too noisy, or too generic.
Turn this local skill into a public GitHub-ready skill.
I downloaded this skill. Tune it to my local workflow and usage habits.
This skill does not trigger when I say things naturally. Personalize it for me.
What Each Skill Does
skill-miner
- coding-agent session history, memory summaries, repo notes, repeated scripts, and project folders
- recurring user intents, shorthand, tool chains, artifacts, and verification patterns
- candidates that are repeated and non-obvious enough to become skills
- whether a candidate should stay personal, be generalized for publication, or be skipped
- includes
scripts/scan_sessions.pyfor a deterministic first-pass scan of Codex, Claude Code, Gemini/Antigravity task files, and exported transcripts from other agents - includes archived Codex sessions and rollout summaries by default, with flags to disable archive/summary sources
Example:
python3 skills/skill-miner/scripts/scan_sessions.py --days 30 --limit 300 --min-count 3
python3 skills/skill-miner/scripts/scan_sessions.py --export ~/Downloads/cursor-chat-export.json
python3 skills/skill-miner/scripts/scan_sessions.py --patterns ./my-patterns.json
python3 skills/skill-miner/scripts/scan_sessions.py --no-include-archives --no-include-summaries
skill-generalizer
- private paths, hosts, credentials, account names, transcript quotes, and internal repo facts
- public portability of commands, examples, README claims, and install instructions
- frontmatter that describes when to use the skill rather than the workflow
- packaging structure for public distribution
skill-personalizer
- local installed copies and nearby project instructions
- real user phrasing and recurring task patterns
- preferred CLIs, MCP tools, paths, aliases, and verification commands
- undertrigger, overtrigger, and unnecessary-question friction
- original optimizer-style audit checks: trigger fit, user reaction, workflow completion, static quality, conflicts, environment consistency, token economics, and P0/P1/P2 fixes
Compatibility
Works with agents that support the Agent Skills folder convention:
- Claude Code
- Codex
- Cursor
- OpenCode
- Gemini CLI
Research Background
This project is informed by Agent Skills ecosystem work and LLM-agent research on externalized memory, skill libraries, retrieval/routing, and long-context behavior. See docs/research-background.md.
AI And Search Visibility
- Project site: https://hqhq1025.github.io/skill-optimizer/
- LLM summary: llms.txt
- Full LLM context: llms-full.txt
- Structured metadata: repo-metadata.json
License
MIT
// HOW IT'S BUILT
KEY FILES