Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Skill Optimization Report · sickn33 | DecimalAI

agent toolingby sickn33

Skill Optimization Report

sickn33/skill-optimizer

Source sickn33/agentic-awesome-skills ↗License MIT

Diagnose and optimize Agent Skills (SKILL.md) with real session data and research-backed static analysis. Works with Claude Code, Codex, and any Agent Skills-compatible agent.

SkillScore55Maintained

Automatic

AI Engineer pack

Last verified 8/11/2026

What it changes

Passed 9 of 17 test cases with the skill, and 5 of 17 without it.

Without skill32%

With skill55%

Checks it passed that the model alone missed

Weights the Trigger Rate dimension at 25% of the total score
Identifies workflow overlap where two skills instruct similar processes
Assigns P0 priority to description rewrites for compounding undertrigger risks

and 4 more in the full report

6 fixed6 passed either way9 still failing1 broke

Pass-rate lift: +23 pp
Tokens: +113%
Agent turns: 0%
Response time: -46%

Model gemini-3.6-flashMeasured 8/11/2026v112 of 22 cases passed with skill · 17 comparable

Tokens, turns and time describe resource use, not a dollar price.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/sickn33-skill-optimizer/SKILL.md https://app.decimal.ai/s/sickn33-skill-optimizer/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add sickn33-skill-optimizer, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/sickn33-skill-optimizer/ and pins it in .decimal/skills.lock

decimalai skills add sickn33-skill-optimizer

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/sickn33-skill-optimizer/SKILL.md https://app.decimal.ai/s/sickn33-skill-optimizer/SKILL.md

Raw file: /s/sickn33-skill-optimizer/SKILL.md ↗ · machine-readable summary at /s/sickn33-skill-optimizer.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

See it in action

One of 6 test cases the skill fixed. Same model, same prompt, with and without the skill.

1 of 6

Prompt

When calculating a skill's composite 1-5 score, which evaluation dimension carries the highest single weight percentage in the scoring model?

What was checked, without and with the skill
Checked	Without skill	With skill
Weights the Trigger Rate dimension at 25% of the total score	Missed	Passed

case-15 · gemini-3.6-flash · 8/11/2026 · answers are capped and redacted

What's inside

The instructions your model reads when the skill loads.

SKILL.md263 linessingle file

When to Use This Skill

Use when skills are not triggering as expected or seem broken
Use when you want to audit and improve your skill library's quality
Use when you want to understand which skills are underperforming or wasting context tokens

Rules

Read-only: never modify skill files. Only output report.
All 8 dimensions: do not skip any. If data is insufficient, report "N/A — insufficient session data" rather than omitting.
Quantify: "you had 12 research tasks last week but the skill never triggered" beats "you often do research".
Suggest, don't prescribe: give specific wording suggestions for description improvements, but frame as suggestions.
Show evidence: for undertrigger claims, quote the actual user message that should have triggered the skill.
Evidence-based suggestions: when suggesting description rewrites, cite the specific research finding that motivates the change (e.g., "front-load trigger keywords — MCP study shows 3.6x selection rate improvement").

Overview

Analyze skills using historical session data + static quality checks, output a diagnostic report with P0/P1/P2 prioritized fixes. Scores each skill on a 5-point composite scale across 8 dimensions.

CSO (Claude/Agent Search Optimization) = writing skill descriptions so agents select the right skill at the right time. This skill checks for CSO violations.

Usage

/optimize-skill → scan all skills
/optimize-skill my-skill → single skill
/optimize-skill skill-a skill-b → multiple specified skills

Data Sources

Auto-detect the current agent platform and scan the corresponding paths:

Source	Claude Code	Codex	Shared
Session transcripts	`~/.claude/projects/*/.jsonl`	`~/.codex/sessions/*/.jsonl`	—
Skill files	`~/.claude/skills/*/SKILL.md`	`~/.codex/skills/*/SKILL.md`	`~/.agents/skills/*/SKILL.md`

Platform detection: Check which directories exist. Scan all available sources — a user may have both Claude Code and Codex installed.

Workflow

Track record

Benchmark

9 / 17

test cases passed, vs 5 / 17 without

Adoption

Users: 0
Times used: 0

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/3/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

sickn33 / agentic-awesome-skills

skills/skill-optimizer/SKILL.md

View on GitHub ↗

License MITImported 8/3/2026Version v1

More skills from the same source and nearby in the registry, with their headline benchmark lift.