skillhone
SkillHone — toolkit for evaluating, optimizing, and managing agent skills. Use when asked to "evaluate a skill", "run probe", "optimize/iterate a skill", "create a new skill experiment", "seed a skill repo", or "run skill benchmarks"; also use when the user mentions a Forgejo-hosted skill repo and wants to measure or improve its quality. Wraps standalone scripts: status, eval, optim, new, seed, serve, synth.
npx skills add Tencent/SkillHone --skill skillhone --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# SkillHone SkillHone is a measurement harness plus an optimization toolkit for agent skills. The important abstraction is not a fixed workflow; it is the evidence trail created when a skill is run against private eval tasks. The harness has these layers: - **Skill repo**: public behavior to improve (`SKILL.md`, scripts, references). - **Eval repo**: private measurement contract (datasets, verifier, synthesis contract, task-local validators). - **Solver workdirs**: isolated per-item sandboxes containing artifacts and `trajectory.jsonl`. - **Observation records**: redacted probe results, trajectory diagnosis, compiler/validator diagnosis, issues, PRs, and wiki pages. When improving a skill, identify which layer explains the failure before changing code. A score drop may point to skill instructions, but it can also be a harness, verifier, compiler, artifact-path, or infrastructure problem. Standalone scripts live under `scripts/`. Pick one based on the task in front of you. Before starting a diagnosis, development, PR review, merge, or optimization cycle on a Forgejo-backed repo, run `scripts/status.py` so you know the current issue/PR state and do not duplicate work or merge the wro
- Eval Synthesis Contract
- Scripts
- Upstream binding & sync
- Quick examples
- Gotchas
- How this skill composes
- Orchestration: "synthesise and optimise a skill from <PRD>"
- References (load on demand)
Status — read-only dashboard of Issues + PRs for the current Forgejo repo python3 scripts/status.py Evaluate — runs probe split, writes result.json python3 scripts/eval.py --skill-dir ./my-skill --eval-dir ./my-skill-eval \ Optimize — agent-driven loop (5 iters, stop after 2 with no gain) python3 scripts/optim.py --repo http://forgejo/skillhone/my-skill.git \ New experiment — creates skill-repo + eval-repo on Forgejo python3 scripts/new.py deep-research \ Seed an empty skill — generate SKILL.md from a brief python3 scripts/seed.py --repo http://forgejo/skillhone/my-skill.git
What does the skillhone skill do?
SkillHone — toolkit for evaluating, optimizing, and managing agent skills. Use when asked to "evaluate a skill", "run probe", "optimize/iterate a skill", "create a new skill experiment", "seed a skill repo", or "run skill benchmarks"; also use when the user mentions a Forgejo-hosted skill repo and wants to measure or improve its quality. Wraps standalone scripts: status, eval, optim, new, seed, serve, synth.
How do I install it?
Run `npx skills add Tencent/SkillHone --skill skillhone --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From Tencent/SkillHone, a repository with 107 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.