Skip to content

Commit 870d7e2

Browse files
skill-evolution: drop inline provenance markers (#1161)
## Summary Removes the `<!-- skill-evolution:start --> ... <!-- skill-evolution:end -->` HTML-comment marker requirement for inline edits to existing SKILL.md files. The markers add visible noise that compounds across many small edits, while `git log` / `git blame` already attribute every line to its origin commit. Audit trail now relies on a clear commit subject (e.g. "skill-evolution: add ... to lp-milp-formulation"). Frontmatter `origin: skill-evolution` for new skills and `# origin: skill-evolution` headers for code assets are kept — those edits are creating new files, not editing existing prose. Distillation checklist updated to remove the marker requirement. ## Testing - `./ci/utils/validate_skills.sh` passes ## Docs - Skill content only. Authors: - Ramakrishnap (https://github.com/rgsl888prabhu) Approvers: - Trevor McKay (https://github.com/tmckayus) URL: #1161
1 parent 2e8e617 commit 870d7e2

1 file changed

Lines changed: 3 additions & 27 deletions

File tree

skills/skill-evolution/SKILL.md

Lines changed: 3 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -179,35 +179,11 @@ After inference interactions, review accumulated insights to find patterns.
179179

180180
## Provenance tagging
181181

182-
Every change made through skill evolution MUST be tagged so its origin is traceable.
182+
Skill-evolution changes need a traceable origin so a reviewer can find and audit them later. The mechanism depends on what is being added.
183183

184184
### Updates to existing skills
185185

186-
Wrap added content with **start** and **end** boundary markers so it is easy to locate, review, and remove:
187-
188-
```markdown
189-
<!-- skill-evolution:start — <short trigger description> -->
190-
<added content>
191-
<!-- skill-evolution:end -->
192-
```
193-
194-
For example, a new table row:
195-
196-
```markdown
197-
<!-- skill-evolution:start — large objective recursion fix -->
198-
| Maximum recursion depth | Building big expr with chained `+` | Use `LinearExpression(vars_list, coeffs_list, constant)` |
199-
<!-- skill-evolution:end -->
200-
```
201-
202-
Or a new subsection:
203-
204-
```markdown
205-
<!-- skill-evolution:start — warmstart gotcha -->
206-
### Warmstart gotcha
207-
208-
Content here...
209-
<!-- skill-evolution:end -->
210-
```
186+
For inline edits to an existing SKILL.md (new bullets, table rows, paragraphs), do NOT wrap content in HTML comment markers. The visible noise compounds across many small edits, and `git log` / `git blame` already attribute every line to the commit that introduced it. Use the commit message and PR description as the audit trail: write a clear commit subject (e.g. "skill-evolution: add large-objective recursion gotcha to lp-milp-formulation") so the origin is greppable in history.
211187

212188
### New skills
213189

@@ -277,9 +253,9 @@ Before proposing, verify:
277253
- [ ] It does not modify this skill (`skill-evolution`)
278254
- [ ] It does not expand agent permissions or reduce user control
279255
- [ ] Code examples do not contain injection patterns (`eval`, `exec`, `os.system` with user input)
280-
- [ ] Added content is wrapped with `<!-- skill-evolution:start -->` / `<!-- skill-evolution:end -->` markers
281256
- [ ] New skills have `origin: skill-evolution` in frontmatter
282257
- [ ] Code assets have `# origin: skill-evolution` header and are runnable
258+
- [ ] Commit subject starts with `skill-evolution:` so the audit trail is greppable from `git log`
283259
- [ ] Placed in the single highest-impact skill (common > API > new); not duplicated across skills
284260
- [ ] Phase is correctly identified (learning/inference/reflection)
285261
- [ ] Learning-phase proposals include a score; inference-phase proposals are marked unscored

0 commit comments

Comments
 (0)