Tooluck logoTooluck
SKILL.md

run-history-skill-builder

Agent skill fromdongshuyan/compass-skills

Turn a completed task, browser flow, artifact pipeline, failure-recovery trace, or repeatedly refined workflow into a new reusable skill package or a reviewed skill-design plan. Use when the user asks to make a new skill from real run history, extract a reusable workflow from conversation/logs/files, summarize lessons into a new skill, or produce a plan before writing files. Do not use to upgrade an existing skill or to execute the business workflow itself.

How to install run-history-skill-builder

install run-history-skill-builder
# install the compass-skills pack with the skills CLI
npx skills add dongshuyan/compass-skills

# or add only this skill to Claude Code: copy the folder

skills/run-history-skill-builder/

# into

~/.claude/skills/run-history-skill-builder/ (all projects)

.claude/skills/run-history-skill-builder/ (one project)

skills/run-history-skill-builder/SKILL.md

MITFull file
1# Run History Skill Builder
2
3## Language Policy
4
5Write all user-facing output in the user's language. Default to Chinese when the language is unknown.
6
7## Role
8
9Turn real run history into a new skill package, a plan-only skill design, or an upgrade handoff when the request is actually about an existing skill.
10
11## Portability
12
13This skill is agent-agnostic. It should work in Codex, Claude Code, OpenCode, OpenClaw, Hermes, and similar local agent hosts that can read `SKILL.md` plus optional `references/`, `scripts/`, `evals/`, and `agents/`.
14
15- Resolve `<skill-dir>` from the directory that contains this `SKILL.md`.
16- Let `<python>` mean the host's available Python launcher: `python3`, `python`, or `py -3`.
17- Do not assume a fixed skill root, shell, home-directory layout, or path separator.
18- Placeholder paths such as `<skill-dir>/scripts/...` describe path segments, not a required separator style. On Windows, use the separator style that your shell or harness accepts.
19- Before writing files, lock the output directory. If the user does not provide one, propose a neutral local target such as the current repository's `skills/` directory or the host agent's documented local skills directory, then wait for confirmation.
20
21## Workflow
22
231. Lock intent: decide whether the request is `plan_only`, `new_single_skill`, `router_skill`, `skill_suite`, or `existing_skill_upgrade_handoff`.
24…

Excerpt shown under the repository's MIT license.

More skills in compass-skills

Keep exploring

Similar skill repositories

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates