run-history-skill-upgrader

Featured

Use real run evidence, validation failures, source drift, platform drift, and user feedback to plan and, only after explicit approval, apply structural upgrades to an existing skill. Use when the user asks to improve an existing skill from recent runs, recurring failures, outdated sources, excessive bloat, changed platform behavior, or validated workflow feedback. Do not use to create a brand-new skill or to execute the business workflow itself.

AI & Automation 725 stars 60 forks Updated 2 weeks ago MIT

Install

View on GitHub

Quality Score: 89/100

Stars 20%
95
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Run History Skill Upgrader ## Language Policy Write all user-facing output in the user's language. Default to Chinese when the language is unknown. ## Role Turn real run feedback into structural net improvement for an existing skill. Upgrades may add, modify, merge, delete, deprecate, or decide not to change anything. ## Portability This 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/`. - Resolve `<skill-dir>` from the directory that contains this `SKILL.md`. - Let `<python>` mean the host's available Python launcher: `python3`, `python`, or `py -3`. - Do not assume a fixed skill root, shell, home-directory layout, or path separator. - 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. - Treat platform-specific helper tooling as optional. Use it only when it is actually available. ## Mandatory Two-Stage Approval This skill always starts in `plan_only`. 1. `plan_only`: read the target skill and the agreed evidence scope, then produce a concrete upgrade plan and stop. 2. `apply_after_approval`: modify files only after the user explicitly approves that specific plan. The following are **not** approval by themselves: - "upgrade it"; - "directly edit it"; - "don't ask me"; - "go ah...

Details

Author
dongshuyan
Repository
dongshuyan/compass-skills
Created
2 months ago
Last Updated
2 weeks ago
Language
Python
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Featured

run-history-skill-builder

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.

725 Updated 2 weeks ago
dongshuyan
AI & Automation Listed

self-update-skills

Audit and safely improve any existing agent skill when authoritative documentation, product features, APIs, policies, standards, user corrections, observed failures, or better workflows make it stale or incomplete. Use when asked to refresh, modernize, maintain, self-evaluate, or self-update a skill; when new information discovered during another task may affect a relevant skill; or when checking a skill library for drift. Research and propose changes first, require explicit user approval before editing, then make narrow updates with validation, regression checks, provenance, and rollback. This skill governs updates to other skills as well as itself.

0 Updated 1 weeks ago
apnatvar
AI & Automation Solid

update-skill

Thorough on-demand refresh of one skill in a skills repo - researches usage, upstream, and docs in parallel, gates twice for approval, bumps version, updates CHANGELOG, validates, commits, watches CI. Use to check a skill's freshness.

36 Updated today
tenequm