Install any skill in seconds. Free to start, no credit card required.
Get Started Free →waylish/skillopt-skill-writer
Create, improve, and validate agent skills using a SkillOpt-inspired workflow: scored evidence, bounded add/delete/replace edits, validation gates, rejected-edit memory, and compact deployable SKILL.md artifacts.
Passed 17 of 20 test cases with the skill, and 11 of 20 without it.
and 10 more in the full report
7 fixed12 passed either way3 still failing1 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 7 test cases the skill fixed. Same model, same prompt, with and without the skill.
When executing environment detection for a skill optimization session, the command `rg --version` fails because ripgrep is not installed. What fallback command should be run, and what state marker should be recorded?
| Checked | Without skill | With skill |
|---|---|---|
| Uses grep --version as the fallback detection command when ripgrep is unavailable. | Passed | Passed |
| Outputs no-fast-search as the detected state marker if both ripgrep and grep fail. | Missed | Passed |
The instructions your model reads when the skill loads.
Use this skill to write or improve agent skills as compact, testable procedural artifacts. The method is inspired by SkillOpt: treat one SKILL.md as the trainable state, make bounded edits, accept changes only after validation, and keep rejected edits as negative feedback.
中文使用原则:当用户用中文描述需求时,用中文产出 brief、验证说明和最终回复;SKILL.md 的技术标识、文件名、命令、frontmatter 字段保持英文或 ASCII。触发词、README、模板和说明应尽量中英文双语,方便中文用户使用,也方便 GitHub 搜索。
Run only the checks that are relevant to the current environment. If a command is unavailable, use the fallback path and record the gap.
Detection commands:
!pwd || cd
!rg --version || grep --version || echo "no-fast-search"
!git --version || echo "no-git"
!rg --files -g SKILL.md . || find . -maxdepth 4 -name SKILL.md || dir /s /b SKILL.md
!test -f SKILL.md && echo "current-skill" || echo "no-current-skill"
Decision tree:
| Detected state | Path |
|---|---|
| User provided a workflow but no existing skill | Create a new skill from a seed draft |
User provided an existing SKILL.md | Improve it with bounded edits |
| User provided tasks, expected outputs, tests, or scorer | Use scored validation gate |
| No scorer or test tasks are available | Use static rubric + 2-3 dry-run prompts and mark as dry_run |
| Git is available and workspace is a repo | Keep before/after diff and avoid unrelated changes |
| Git is unavailable | Keep an edit log in rejected_edits.md / validation_notes.md |
Exit gate: identify mode (create, improve, or evaluate), available validation path, target runtime, and output location.
Extract the minimum brief before drafting. Do not stall if fields are missing; use the defaults table.
| Parameter | Default | Rationale |
|---|---|---|
| Target runtime | Codex-compatible SKILL.md | Current environment uses Codex skills |
test cases passed, vs 11 / 20 without
Published skills whose descriptions closely match this one, with their headline benchmark lift.
More skills from the same source and nearby in the registry, with their headline benchmark lift.