skill-optimizer SKILL.md skillA

skill-optimizer from s977043/river-review is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add s977043/river-review/skill-optimizer@git:20261004.95d1f7a

Pins git:20261004.95d1f7a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
s977043/river-review
Path
.claude/skills/skill-optimizer/SKILL.md
Versions recorded
4
Latest version
git:20261004.95d1f7a, committed Oct 4, 2026
First version recorded
Mar 21, 2026
Size
5,346 bytes
Repository stars
7
License
MIT

Evaluate and improve an existing Claude Code skill using explicit success criteria and small controlled changes. Use when the user asks to optimize a skill, reduce over-triggering or under-triggering, improve reliability, tighten instructions, or add evals for a skill. Also trigger on "スキルを改善して", "スキルを最適化して", "スキルの品質を確認して".

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

## Pattern declaration

Primary pattern: Reviewer
Secondary patterns: Pipeline
Why: optimization starts with diagnosis against criteria, then applies small changes in a controlled sequence with eval checkpoints.

## Purpose

Improve an existing skill without breaking what already works.

Your job is to:

1. inspect the current skill package
2. define or refine success criteria
3. identify failure modes
4. propose one small change at a time
5. attach each change to an eval hypothesis
6. reject changes that cannot be evaluated

## Core optimization rule

Never apply a large rewrite first.

Optimize in small units:

- description
- gate logic
- workflow order
- examples
- prohibited behaviors
- output contract
- review checklist
- supporting file structure

Change only one major unit per proposal.

## Phase 0: Baseline audit

Inspect:

- current `SKILL.md`
- current `SKILL.md` entrypoint size (UTF-8 bytes / lines) and whether optional knowledge is eagerly loaded
- current supporting files
- invocation settings
- current examples
- current failure reports or user complaints
- existing eval cases if any

Then summarize:

- what the skill is supposed to do
- where it fails
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add s977043/river-review/skill-optimizer@sha256:9d389a2762ed6584

The line at the top of this page pins the label git:20261004.95d1f7a, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_dst2r5n67ozqlkmo.svg)](https://markdownregistry.com/a/art_dst2r5n67ozqlkmo)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Mar 21, 2026 and Oct 4, 2026, about one every 66 days.

versioncommittedcommitsizeaudit
git:20261004.95d1f7a latest2026-10-04 95d1f7a 5,346 BA view · diff
git:20260321.857d5ca2026-03-21 857d5ca 4,547 BA view · diff
git:20260321.9fa274a2026-03-21 9fa274a 4,429 BA view · diff
git:20260321.8fae2382026-03-21 8fae238 3,530 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (5346 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

s977043/river-review · 7 stars · license MIT · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_dst2r5n67ozqlkmo
GET https://markdownregistry.com/api/v1/resolve?ref=s977043/river-review/skill-optimizer
GET https://markdownregistry.com/api/v1/blob/9d389a2762ed65845e6c3944887e2ef1d3278760815ffb1e7c1f69b82ad47320

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from s977043/river-review

ask-codex SKILL.md skill
s977043/river-review · .claude/skills/ask-codex/SKILL.md · Get a second opinion or independent review from Codex (OpenAI) via the local Codex CLI. Use when the user wants Codex…
git:20260724.d54eafd · audit A · 7 stars
river-review-discipline SKILL.md skill
s977043/river-review · .claude/skills/river-review-discipline/SKILL.md · AI 駆動開発のレビュー品質を安定化させるレビュー規律。レビュー対象を分類し、要件・設計・差分・検証・報告を分けて見て、根拠に基づき approved / needs_revision / blocked / rejected…
git:20260707.9c35a5d · audit A · 7 stars
skill-creator SKILL.md skill
s977043/river-review · .claude/skills/skill-creator/SKILL.md · Design a new Claude Code skill from a concrete use case and produce a repo-ready skill package. Use when the user asks…
git:20261004.95d1f7a · audit A · 7 stars
skill-ops-planner SKILL.md skill
s977043/river-review · .claude/skills/skill-ops-planner/SKILL.md · Create an operating policy and roadmap for a live portfolio of Claude Code skills. Use when the user asks to organize…
git:20260321.857d5ca · audit A · 7 stars
AGENTS.md@.codex AGENTS.md file
s977043/river-review · .codex/AGENTS.md
git:20260923.5650e78 · audit A · 7 stars
AGENTS.md AGENTS.md file
s977043/river-review · AGENTS.md
git:20261008.d74129b · audit B · 7 stars
CLAUDE.md CLAUDE.md file
s977043/river-review · CLAUDE.md
git:20261016.787c99c · audit A · 7 stars
Sample Architecture Consistency Review SKILL.md skill
s977043/river-review · examples/skills/architecture-sample/SKILL.md · Checks design/ADR docs for consistency and missing decisions.
v0.1.0 · audit A · 7 stars
Sample Code Quality Pass SKILL.md skill
s977043/river-review · examples/skills/code-quality-sample/SKILL.md · Checks common code quality and maintainability risks.
v0.1.0 · audit A · 7 stars
Sample Test Coverage Review SKILL.md skill
s977043/river-review · examples/skills/test-review-sample/SKILL.md · Evaluates downstream tests for coverage and edge cases.
v0.1.0 · audit A · 7 stars
adversarial-review SKILL.md skill
s977043/river-review · plugin-dist/river-review/skills/agent-skills/adversarial-review/SKILL.md · 敵対的分析手法を統合したレビューの entry skill。認知バイアス対策の3手法 (Pre-mortem / War Game / Logic Torturing)と、宣言・主張と実態の乖離を突く claim-vs-actual…
v0.1.0 · audit A · 7 stars
review-team SKILL.md skill
s977043/river-review · plugin-dist/river-review/skills/agent-skills/review-team/SKILL.md · 6つの専門レビュアーロールを並列実行し、consensusLevel(複数ロールの合意度)と Tech Lead レポート(top3指摘・blindSpots・consensusSummary)で結果を統合する マルチエージェントレビュー…
v0.1.1 · audit A · 7 stars

Every file in s977043/river-review

Other files named skill-optimizer

skill-optimizer SKILL.md skill
garrytan/gbrain · skills/skill-optimizer/SKILL.md · Self-evolving skill optimization via SkillOpt-paper-grounded text-space optimizer.
v0.1.0 · audit A · 31,463 stars
skill-optimizer SKILL.md skill
garrytan/gbrain · plugin/skills/skill-optimizer/SKILL.md · Self-evolving skill optimization via SkillOpt-paper-grounded text-space optimizer.
v0.1.0 · audit A · 31,463 stars
skill-optimizer SKILL.md skill
rohitg00/pro-workflow · skills/skill-optimizer/SKILL.md · SkillOpt-flavored offline training loop for any SKILL.md. Treats accumulated learn-rule corrections as training…
git:20260929.86d5f27 · audit A · 2,940 stars
skill-optimizer SKILL.md skill
tdimino/claude-code-minoan · skills/core-development/skill-optimizer/SKILL.md · Guide creating and reviewing skills that extend Claude with specialized knowledge, workflows, or tool integrations…
git:20260416.4e43d41 · audit A · 41 stars
skill-optimizer SKILL.md skill
mckruz/microsoft-agentic-harness · skills/skill-optimizer/SKILL.md · Reads the evidence from a skill's recent runs and returns an improved version of that skill, or leaves it unchanged.
v1.0.0 · audit A · 16 stars
skill-optimizer SKILL.md skill
wangjs-jacky/jacky-skills · plugins/skill-tooling/skills/skill-optimizer/SKILL.md · 诊断并优化 Skills 的持续改进工具,支持调用 efficiency-audit 进行效率审计。触发词:优化 skill、skill 没触发、为什么没有、skill 诊断、skill-optimizer
git:20260711.2d2cc18 · audit A · 15 stars

Browse by kind, by grade A, or by owner.