Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions agent-improvement/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -97,6 +97,22 @@ point, stale by default. Verify anything actionable against live state before ac
present β€” **stop and report**, change nothing. Never improve what you cannot see, and never improvise
the procedure from the bootstrap entry alone.

**Contract guard β€” check this yourself; do not assume a wrapper did.** This skill can be invoked
directly, without any agent definition around it, so it must establish its own bounds before step 4
routes a change at a bootstrap entry or a permission file. Confirm the consuming deployment's contract
defines both:

- **Agent definition locations** β€” every surface you may change, and which are version-controlled
(ship as a pull request) versus not (bootstrap/loader entries, permission or approval configuration
β€” edited in place, backed up first). Anything not named there is out of scope.
- **Authority model** β€” how much you may change alone, stated separately for **tightening** versus
**loosening** a guardrail, and for the prose definition versus the enforcement layer.

**If either is missing or malformed, fail closed on that dimension**: report the gap and change
nothing that depends on it. Do not infer which surfaces are yours, and do not assume an authority you
were not granted. This guard is load-bearing precisely because the skill edits guardrails β€” improvising
its own bounds would remove them before any other check runs.

---

## 1. Gather
Expand Down Expand Up @@ -169,6 +185,14 @@ ships as a **pull request**; a non-version-controlled surface (a bootstrap entry
approval configuration) is edited in place **after backing it up** to a timestamped copy naming the
reason.

**A VENDORED copy is not the surface β€” fix it at its upstream.** Where a definition file was installed
from somewhere else (a bundled skill in a plugin or marketplace, a vendored agent definition), the copy
usually records its origin in frontmatter or a lockfile, and the consuming repository generally forbids
hand-editing it β€” a local edit is silently reverted by the next sync, so the defect returns and the fix
looks like it failed. Change it in the repository it came from, let the normal sync carry it, and note
the upstream link in your report. Check for that origin marker before editing any definition file you
did not author.

**Every change carries its evidence** β€” the signature, the count, the window. **Every change is
reversible**, and the before/after goes into memory and the run report: a pull request is auditable by
version history, an in-place edit only if you made it so.
Expand Down
Loading