skillopt-evolve-skills
Evolve Codex skills and agent instructions with a SkillOpt-style loop. Use when creating, refining, or auditing local skills, AGENTS.md rules, prompt playbooks, or reusable agent workflows after repeated task experience, especially when the user asks to "improve your skills", "ca
Install
npx skills add https://github.com/markoblogo/abvx-agent-skills/tree/main/skills/skillopt-evolve-skills
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install markoblogo-abvx-agent-skills@llmmart
git clone https://github.com/markoblogo/abvx-agent-skills.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole markoblogo/abvx-agent-skills collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
SkillOpt Evolve Skills
Use this skill to improve reusable agent behavior as a versioned artifact, not as a one-off prompt rewrite.
Layer Check
Before editing a skill, use agent-learning-layer-triage when the lesson could instead belong in memory, durable repo docs, a checklist, a script/tool, an eval, or a rejected buffer.
Only continue here when the chosen layer is SKILL.md, AGENTS.md, or another reusable agent-instruction artifact.
Loop
- Identify the target artifact:
SKILL.md,AGENTS.md, checklist, prompt, or workflow note. - Define the behavior to improve in one sentence.
- Gather evidence from real traces: user requests, command logs, diffs, failures, review comments, screenshots, or final outputs.
- Propose bounded edits only:
append: add a missing rule to the right section.replace: tighten a vague rule.delete: remove a harmful or redundant rule.move: relocate a rule to where it will trigger.
- Generate 2-4 distinct bounded proposals before choosing what to validate. The alternatives should differ in operation, target section, or behavioral effect, not just wording.
- Accept edits only when they are procedural, reusable, and testable.
- Validate against at least one old scenario and one new scenario when feasible.
- Record rejected ideas if they looked plausible but would overfit, duplicate existing rules, or weaken a guardrail.
Edit Budget
Keep skill updates small:
- Prefer 1-4 accepted edits per update.
- Keep each rule action-oriented and no longer than needed.
- Do not add examples unless they prevent a likely mistake.
- Do not duplicate rules already enforced by system, developer, AGENTS.md, or a more specific skill.
- Use
hypothesis-diversificationwhen candidate generation is likely to collapse onto the first plausible edit. - Preserve the existing voice and structure of the artifact.
Validation Gate
Before finalizing a skill change, check:
- Trigger fit: The frontmatter description names the real situations where the skill should load.
- Actionability: The body tells Codex what to do differently, not what to admire or remember abstractly.
- Generalization: The rule applies to a class of tasks, not a single observed example.
- Non-regression: The new rule does not conflict with higher-priority instructions or common workflows.
- Cost: The extra tokens are justified by avoided errors or repeated work.
If validation is weak, leave the candidate as a note instead of merging it into the skill.
Rejected Edit Buffer
When a candidate is rejected, capture the reason briefly:
Rejected: <candidate rule>
Reason: <overfit/conflict/too broad/not validated/duplicate>
Evidence: <trace, task, or check>
Use rejected edits to avoid repeating bad prompt changes.
Final Report
When updating a skill, report:
- changed artifact paths,
- accepted edits in plain language,
- validation performed,
- rejected edits or assumptions if relevant.
Files (abvx-agent-skills)
-
agents
-
openai.yaml 206 B
Loading…
-
-
SKILL.md 3.4 KB
--- name: skillopt-evolve-skills description: Evolve Codex skills and agent instructions with a SkillOpt-style loop. Use when creating, refining, or auditing local skills, AGENTS.md rules, prompt playbooks, or reusable agent workflows after repeated task experience, especially when the user asks to "improve your skills", "capture this lesson", "make this reusable", or "update agent instructions". license: MIT metadata: abvx_status: experimental abvx_origin: adapted --- # SkillOpt Evolve Skills Use this skill to improve reusable agent behavior as a versioned artifact, not as a one-off prompt rewrite. ## Layer Check Before editing a skill, use `agent-learning-layer-triage` when the lesson could instead belong in memory, durable repo docs, a checklist, a script/tool, an eval, or a rejected buffer. Only continue here when the chosen layer is `SKILL.md`, `AGENTS.md`, or another reusable agent-instruction artifact. ## Loop 1. Identify the target artifact: `SKILL.md`, `AGENTS.md`, checklist, prompt, or workflow note. 2. Define the behavior to improve in one sentence. 3. Gather evidence from real traces: user requests, command logs, diffs, failures, review comments, screenshots, or final outputs. 4. Propose bounded edits only: - `append`: add a missing rule to the right section. - `replace`: tighten a vague rule. - `delete`: remove a harmful or redundant rule. - `move`: relocate a rule to where it will trigger. 5. Generate 2-4 distinct bounded proposals before choosing what to validate. The alternatives should differ in operation, target section, or behavioral effect, not just wording. 6. Accept edits only when they are procedural, reusable, and testable. 7. Validate against at least one old scenario and one new scenario when feasible. 8. Record rejected ideas if they looked plausible but would overfit, duplicate existing rules, or weaken a guardrail. ## Edit Budget Keep skill updates small: - Prefer 1-4 accepted edits per update. - Keep each rule action-oriented and no longer than needed. - Do not add examples unless they prevent a likely mistake. - Do not duplicate rules already enforced by system, developer, AGENTS.md, or a more specific skill. - Use `hypothesis-diversification` when candidate generation is likely to collapse onto the first plausible edit. - Preserve the existing voice and structure of the artifact. ## Validation Gate Before finalizing a skill change, check: - **Trigger fit**: The frontmatter description names the real situations where the skill should load. - **Actionability**: The body tells Codex what to do differently, not what to admire or remember abstractly. - **Generalization**: The rule applies to a class of tasks, not a single observed example. - **Non-regression**: The new rule does not conflict with higher-priority instructions or common workflows. - **Cost**: The extra tokens are justified by avoided errors or repeated work. If validation is weak, leave the candidate as a note instead of merging it into the skill. ## Rejected Edit Buffer When a candidate is rejected, capture the reason briefly: ```text Rejected: <candidate rule> Reason: <overfit/conflict/too broad/not validated/duplicate> Evidence: <trace, task, or check> ``` Use rejected edits to avoid repeating bad prompt changes. ## Final Report When updating a skill, report: - changed artifact paths, - accepted edits in plain language, - validation performed, - rejected edits or assumptions if relevant. -
SKILL_CARD.md 1.3 KB
Loading…
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.