SkillsAdd

grandcamel/assistant-skills · Archived

skills-optimizer

Audit and optimize skills for token efficiency and progressive disclosure compliance. Use when user wants to "analyze skill tokens", "audit skills", "optimize skill size", "check token efficiency", or "validate progressive disclosure".

First seen Jul 11, 2026

Installation

$ npx skills add grandcamel/assistant-skills --skill skills-optimizer
View on skills.sh ↗ GitHub repository ↗

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

e2e-testing Same source · more installs
grandcamel/assistant-skills

Set up end-to-end testing infrastructure for Assistant Skills plugins. Use when user wants to "…

2 installs
setup-wizard Same source
grandcamel/assistant-skills

This skill should be used when the user asks to "set up Assistant Skills", "configure venv", "i…

1 installs
safe-mode Same source
grandcamel/assistant-skills

This skill should be used when the user wants to run Claude with risk-based permission enforcem…

1 installs
library-publisher Same source
grandcamel/assistant-skills

Extract shared libraries from Assistant Skills projects and publish them as PyPI packages.

1 installs

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

next-cache-components-optimizer Similar name
vercel/next.js

Drive a Next.js route to instant navigation by setting up an agentic loop, under Cache Componen…

11.8K installs
neon-postgres-egress-optimizer Similar name
neondatabase/agent-skills

>- Diagnose and fix excessive Postgres egress (network data transfer) in a codebase. Use when a…

5.5K installs
mongodb-query-optimizer Similar name
mongodb/agent-skills

>- Help with MongoDB query optimization and indexing. Use only when the user asks for optimizat…

4.9K installs
prompt-optimizer Similar name
getsentry/skills

Creates, optimizes, and iteratively refines agent prompts, system prompts, developer prompts, a…

1.6K installs
markdown-token-optimizer Similar name
microsoft/azure-skills

markdown-token-optimizer — an installable skill for AI agents.

1.1K installs
resume-ats-optimizer Similar name
paramchoudhary/resumeskills

Optimize resumes for Applicant Tracking Systems, check ATS compatibility, and analyze keyword m…

10.4K installs

Also in this package

Other skills from grandcamel/assistant-skills.

npx skills add grandcamel/assistant-skills
e2e-testing 2 setup-wizard 1 safe-mode 1 library-publisher 1 landing-page 1 demo-scaffolding 1 assistant-builder 1

Browse all from grandcamel/assistant-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 1
License LICENSE
Default branch main
Open issues 0
Status Archived

Skill metadata

Parsed from SKILL.md frontmatter.

Declared agents claude-code

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,741 B
  • docs SUMMARY.md 259 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 1 installs

SKILL.md

Skills Optimizer

Audit skills for token efficiency and progressive disclosure compliance.

What This Skill Does

Operation Script Description
Analyze Skill analyze-skill.sh Audit single skill's token footprint
Audit All audit-all-skills.sh Batch audit entire skills directory
Validate validate-skill.sh Check structure and compliance

Quick Start

Audit a Single Skill

./scripts/analyze-skill.sh ~/.claude/skills/my-skill
# Output: Token count, violations, recommendations

Audit All Skills

./scripts/audit-all-skills.sh ~/.claude/skills
# Generates: audit-report.json with per-skill scores

Validation Checklist

  • L1: Description < 1024 chars, includes triggers
  • L2: SKILL.md < 500 lines, navigation guide
  • L3+: Details in separate files
  • No deep nesting: One level from SKILL.md
  • No voodoo constants: No explaining what Claude knows

The 3-Level Disclosure Model

Level Target Loaded When Contains
L1: Metadata ~200 chars Startup (all skills) name, description, triggers
L2: SKILL.md <500 lines Skill triggered Quick start, workflow overview
L3: Nested docs Variable Explicitly accessed API refs, examples, guides

Optimization Workflow

  1. Measure: wc -w SKILL.md (target: <2000 words)
  2. Identify violations (see table below)
  3. Apply fixes
  4. Validate: ./scripts/validate-skill.sh

Common Violations

Violation Detection Fix
Bloated description >1024 chars Trim, front-load keywords
Voodoo constants Explains PDF/JSON/API Delete (Claude knows)
Inline code dumps >50 line blocks Move to scripts/
Deep nesting A→B→C chains Flatten to one level

Router Skill Checks (R001-R005)

Automatically detected for skills mentioning "hub", "router", or "routes to...skills":

Check Description Severity
R001 Quick Reference table with Risk column Warning
R002 Risk Legend present Warning
R003 Negative Triggers documented Warning
R004 Disambiguation examples Warning
R005 Context awareness (pronoun resolution) Info

Risk Level Checks (K001-K003)

Applied to skills with scripts/ directory:

Check Description Severity
K001 Destructive scripts have ⚠️ indicators Warning
K002 Bulk operations marked as ⚠️⚠️ Warning
K003 High-risk ops document --dry-run Warning

Risk Level Reference

Risk Symbol Operations Required Safeguards
Safe - search, list, get, export None
Destructive ⚠️ create, update, delete Confirm
High-risk ⚠️⚠️ bulk ops, admin changes Confirm + dry-run

Audit Report Format

{
  "skill": "my-skill",
  "tokenFootprint": { "level1": 180, "level2": 3200, "level3": 15000 },
  "violations": [...],
  "score": 72,
  "grade": "C"
}

Related Documentation

  • [Disclosure Level Criteria](docs/disclosure-levels.md)
  • [Token Counting Guide](docs/token-counting.md)
  • [Naming Conventions](docs/naming-conventions.md)
  • [Validation Rules](docs/validation-rules.md)