stark-ai-de/agent-skills / incubator/skills/skill-maintenance/skillopt-setup
skillopt-setup
FlaggedSet up Microsoft SkillOpt for Agent Skills improvement. Use when installing SkillOpt, preparing per-skill train/val/test eval splits, configuring Codex CLI or provider-backed execution, running SkillOpt against SKILL.md bodies, reviewing best_skill.md, or importing optimized skill changes. Do not use for ordinary skill authoring or manual repo validation.
references/adoption-policy.md
View on GitHub# Adoption Policy
`best_skill.md` is an optimization candidate, not a merge-ready artifact.
## Required Gates
1. Run `apply-skillopt-best.mjs --dry-run`.
2. Review the change amount, diff, and adoption report.
3. Confirm the candidate preserves frontmatter unless frontmatter optimization was explicitly requested.
4. Reject candidates that weaken safety rules, approval gates, or scope boundaries.
5. Reject candidates with secret-like strings, private local paths, raw transcripts, or optimizer-only workspace paths.
6. Reject candidates when the run summary beside `best_skill.md` records a lower test hard score than the baseline.
7. Require `--approved` before writing tracked files.
8. For promoted public skills, bump `metadata.version` explicitly.
9. Run repo validation after any write.
## Public Evidence
Commit only concise run summaries under `skill-evals/<target>/runs/`. Keep raw trajectories, provider metadata, Codex auth state, local paths, `.env` files, and temporary candidates under ignored `.agents/`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |