Agent skill

Skillhone Auto Optimization

by Tencent in Tencent/SkillHone

Mandatory interception workflow for a reproducible defect encountered while any Agent is using a skill.

Custom licenceAuto-check: warningsDevelopment

Install Skillhone Auto Optimization

The automated check flagged lines worth reading first. See the safety section below.

skills CLI
$ npx skills add Tencent/SkillHone --skill skillhone-auto-optimization -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Tencent/SkillHone skillhone-auto-optimization --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Tencent/SkillHone.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/skillhone-auto-optimization .claude/skills/skillhone-auto-optimization && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
skillhone-auto-optimization
GitHub stars
168
Token cost
~2.1k tokens
SKILL.md length
981 words
Files
2
Skills in repo
3
Repo updated
First seen
Licence
Custom licence

At a glance

Mandatory interception workflow for a reproducible defect encountered while any Agent is using a skill.

  • Works in 9 steps: Pause the user's primary task as soon as… → Reproduce the observation from public… → Reject provider outages, rate limits,… → …
  • Tasks that involve Pull requests
  • SKILL.md covers Mandatory interception boundary, Workflow, Agent command and Composition, plus 1 more section
  • Calls git

What it does

Skillhone Auto Optimization is an agent skill from Tencent/SkillHone. Mandatory interception workflow for a reproducible defect encountered while any Agent is using a skill. Invoke this before editing implementation files or installing dependencies when a referenced script is missing, a documented command or repository test fails, or another target-skill defect is confirmed. First create or reuse a sanitized local Issue, then let SkillHone dispatch the repair into a tested Git-backed pull request. This applies regardless of the Agent, current working directory, or the user's…

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/runtime-issue-reporter.md`).

It sits in Development, covering Pull requests. It works with Git. The repository describes itself as: Continual agent skill evolution through persistent decision history. Whole-skill optimisation (SKILL.md + scripts + references) with every decision landing as a local Git issue /…

When your agent uses it

  • Tasks that involve Pull requests

Example prompts

  • “/skillhone-auto-optimization”

Requirements

  • Python 3

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  1. Pause the user's primary task as soon as the reproducible defect is confirmed.
  2. Reproduce the observation from public target-skill state.
  3. Reject provider outages, rate limits, machine-specific state, user config
  4. Select the exact target repository as described above, run
  5. Create the smallest focused reproduction under .test/, then run
  6. Let the configured trigger policy decide how the queue is consumed, without
  7. Only the dispatched repair Agent may add focused implementation files and
  8. On success, the CLI reruns the Issue tests and records the committed branch
  9. When the user asks to inspect Issues, PRs, trajectories, or completed fixes,

What it can do on your machine

Read from SKILL.md and the folder at commit c613aa9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Skillhone Auto Optimization loads about 2.1k tokens when it runs. Until then it costs about 150 tokens; SKILL.md has 981 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~150
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: warnings

The automated check found patterns that need a careful read before installing.

  • WarningTells the agent its actions are pre-authorized / not to stop for confirmationSKILL.md:155
    - Never ask for permission to consume a queued repair. Repair authorization is

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 981 words (~2,059 tokens).

“This skill owns the automatic runtime-defect workflow. A normal Agent task remains the entry point: when the selected skill fails for a reproducible reason, dispatch here instead of folding maintenance logic into the task skill itself.”

— opening of SKILL.md by Tencent, Custom licence
name
skillhone-auto-optimization

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in skills/skillhone-auto-optimization of Tencent/SkillHone.

  • SKILL.md
  • agents/runtime-issue-reporter.md

Open the folder on GitHubat commit c613aa9

Compare with similar skills

Skillhone Auto Optimization next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Skillhone Auto Optimization compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skillhone Auto Optimization this skillTencent/SkillHone168—~2.1kAutomated safety check: WarnCustom licence
Finishing a Development Branchobra/superpowers296k5 repos~1.9kAutomated safety check: PassMIT
Understand Diff AnalysisEgonex-AI/Understand-Anything85k1 repos~1.4kAutomated safety check: PassMIT
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT
Open Code Review CLIalibaba/open-code-review44k—~3.1kAutomated safety check: PassApache-2.0
Create Pull Requestcline/cline70k1 repos~1.6kAutomated safety check: PassApache-2.0

Similar skills

  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    296k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Understand Diff Analysis

    Egonex-AI/Understand-Anything

    Reads your git changes or a pull request against a prebuilt knowledge graph of the project to explain what changed, which components are affected and what is risky.

    85k GitHub starsUsed in 1 repo~1.4k tokens
    DevelopmentAuto-check passed
  • Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed
  • Open Code Review CLI

    alibaba/open-code-review

    Runs the ocr command-line tool to review Git changes, a commit or a branch comparison with an AI model, returning line-level comments and optionally applying fixes.

    44k GitHub stars~3.1k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Opens a GitHub pull request from your current branch with the gh CLI, after reviewing the commits and diff and gathering the details the PR needs.

    70k GitHub starsUsed in 1 repo~1.6k tokens
    DevelopmentAuto-check passed
  • Pull Request Title and Body Writer

    openinterpreter/openinterpreter

    Rewrites the title and body of one or more pull requests with gh, leading with why the change was made, then what changed, and describing only the net result.

    69k GitHub starsUsed in 2 repos~1.1k tokens
    DevelopmentAuto-check passed

More from Tencent/SkillHone

  • Skillhone

    Tencent/SkillHone

    Local Issue, pull-request, and Wiki workbench for agent skills.

    168 GitHub stars~3.4k tokensUpdated 18 days ago
    Auto-check passed
  • Run the additional paper-compatible optimization workflow with a frozen benchmark repository.

    168 GitHub stars~1.5k tokensUpdated 18 days ago
    Auto-check passed

Works with

Categories

Questions about Skillhone Auto Optimization

What does Skillhone Auto Optimization do?

Mandatory interception workflow for a reproducible defect encountered while any Agent is using a skill. Skillhone Auto Optimization is an agent skill from Tencent/SkillHone. Mandatory interception workflow for a reproducible defect encountered while any Agent is using a skill.

When should I use Skillhone Auto Optimization?

Skillhone Auto Optimization fits situations like: tasks that involve Pull requests.

How do I install Skillhone Auto Optimization in Claude Code?

Run `npx skills add Tencent/SkillHone --skill skillhone-auto-optimization -a claude-code`. Or copy the skill folder (skills/skillhone-auto-optimization in Tencent/SkillHone) into .claude/skills/skillhone-auto-optimization in your project. Claude Code loads it when a task matches its description.

How do I install Skillhone Auto Optimization in Codex?

Run `npx skills add Tencent/SkillHone --skill skillhone-auto-optimization -a codex`. Or copy the skill folder (skills/skillhone-auto-optimization in Tencent/SkillHone) into .agents/skills/skillhone-auto-optimization in your project. Codex loads it when a task matches its description.

Can I use Skillhone Auto Optimization in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Tencent/SkillHone --skill skillhone-auto-optimization -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skillhone-auto-optimization, .gemini/skills/skillhone-auto-optimization, .github/skills/skillhone-auto-optimization and .opencode/skills/skillhone-auto-optimization in your project.

What does Skillhone Auto Optimization need to run?

Going by SKILL.md and its folder, Skillhone Auto Optimization needs the command-line tools its instructions call (git). Our summary lists: Python 3.

Does Skillhone Auto Optimization access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Skillhone Auto Optimization safe to install?

Our automated static check of SKILL.md flagged 1 warning(s): tells the agent its actions are pre-authorized / not to stop for confirmation. Read the flagged lines before installing; the check is not a guarantee either way.

What licence does Skillhone Auto Optimization use?

Skillhone Auto Optimization has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Skillhone Auto Optimization use?

About 2.1k tokens (SKILL.md is roughly 8.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Skillhone Auto Optimization?

Skills that share tags, products or a category with Skillhone Auto Optimization: Finishing a Development Branch (obra/superpowers, 296k stars), Understand Diff Analysis (Egonex-AI/Understand-Anything, 85k stars), Contributor-First PR Merge (HKUDS/OpenHarness, 16k stars) and Open Code Review CLI (alibaba/open-code-review, 44k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Skillhone Auto Optimization?

Tencent (a GitHub organization) maintains it in Tencent/SkillHone, which has 168 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on September 19, 2026.

Source: Tencent/SkillHone on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.