<div align="center">
# SkillHone
**Continually improve your Agent Skills — and keep what was learned.**
[](https://aclanthology.org/2026.emnlp-industry.105/)
[](https://github.com/Tencent/SkillHone/releases)
[](skills/)
[](https://github.com/Tencent/SkillHone/actions/workflows/ci.yml)
[](LICENSE)
[Get started](#get-started) · [中文](docs/README.zh.md) ·
[Public example](examples/phoenix-tracing/) · [Paper](https://aclanthology.org/2026.emnlp-industry.105/)
</div>
## Get started
Give your coding Agent this prompt:
> Install SkillHone from `https://github.com/Tencent/SkillHone`, following
> `docs/install/skillhone.md`. Make the CLI and Skills available to this Agent,
> use the documented `--install-links=true` Git installation command, and
> verify the installation.
Prefer the terminal? Start with the [installation guide](docs/install/skillhone.md)
for installation, provider configuration, and verification.
## Why SkillHone
**Accepted at EMNLP 2026 Industry Track.** The paper reports **+15.8 points on
GAIA** and **+3.2 points on WebWalkerQA-EN** against its commercially backed
deep-research baseline, without a pre-integrated search stack.
[Read the paper and evaluation context](https://aclanthology.org/2026.emnlp-industry.105/).
An Agent hits a missing script, a broken reference, or an outdated instruction.
SkillHone captures the evidence, repairs the **complete Skill repository**, and
returns a tested local PR. The Issue, test, diff, run and decision stay together,
so the next Agent can build on what was learned.
Works with CLI-capable Agents, including **Codex, Claude Code, Cursor, Pi and
ZCode**. New installations use the current Agent for repair assignments,
preserving its model and account. [DeepSeek Harness](docs/deepseek-harness.md)
is an optional managed executor; existing installations retain their saved
choice. The host verifies the committed repair and linked tests before a PR.
## SkillHone in 35 seconds
https://github.com/user-attachments/assets/69bafb25-5ba9-44cb-b5ff-8a2a94f8e51a
<details>
<summary>Inspect the current workbench</summary>
See which Skills need attention, expand their repair records, and inspect each local PR before merging.
</details>
**Reproduce a real repair.** The [Phoenix tracing walkthrough](examples/phoenix-tracing/) starts with four referenced documents that were never shipped, then follows the failure, regression test and repair evidence. Public source: [Issue #2567](https://github.com/github/awesome-copilot/issues/2567) · [merged fix #2568](https://github.com/github/awesome-copilot/pull/2568).
## What stays with the fix
| You need | SkillHone keeps |
|---|---|
| A problem the next Agent can reproduce | One Issue with sanitized evidence and a linked regression test |
| A complete repair | Changes to `SKILL.md`, scripts, references, assets and tests in one Git diff |
| A result you can review | Test outcomes, repair run, commits and a local PR |
| A reason the next Agent can reuse | Per-Skill Wiki records and persistent decision history |
Repairs use isolated branches. **Review is the default**; automatic local merge
is opt-in and requires linked tests to pass. Pushing remains a separate user
action. The [local workbench](docs/install/developer.md#run-the-workbench) brings
Issues, runs, PRs, approval state and Wiki records into one view.
## Two ways to improve a Skill
| | Runtime maintenance | Evaluation-driven optimization |
|---|---|---|
| Start with | A reproducible failure encountered during real work | A frozen dataset and verifier in a separate Eval repository |
| Use it for | Missing files, broken scripts, stale instructions and API drift | Broader capability and quality improvements |
| Review | Issue, regression, repair and local PR | Baseline, candidate iterations, validation and local PR |
| Learn more | [Runtime workflow](skills/skillhone-auto-optimization/SKILL.md) | [Benchmark workflow](docs/benchmark-optimization.md) |
## Research and citation
> Zhiwei Li and Yong Hu. *SkillHone: A Harness for Continual Agent Skill
> Evolution Through Persistent Decision History.* EMNLP 2026 Industry Track.
> [ACL Anthology](https://aclanthology.org/2026.emnlp-industry.105/) · [arXiv:2606.08671](https://arxiv.org/abs/2606.08671)
[BibTeX](docs/skillhone.bib) · [CITATION.cff](CITATION.cff)
## Acknowledgements
SkillHone uses [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)
as an optional managed repair executor. Native assignments use the current
Agent instead. Both paths keep test-gated local PRs, evidence, and decision
history in SkillHone; installing DSH is not required for native repair.
[Security](SECURITY.md) · [Contributing](CONTRIBUTING.md) ·
[MIT License](LICENSE) · [Third-party notices](THIRD_PARTY_NOTICES.md)