If you're building or reviewing Agent Skills, this gives you a scoring rubric based on 17+ official examples. It evaluates across dimensions like knowledge delta (does this teach Claude something it doesn't already know?), mindset transfer (does it share expert thinking patterns?), and anti-pattern quality (does it have specific NEVER lists?). The core insight is solid: a good skill is expert-only knowledge minus what Claude already knows, because context window is expensive. Useful for catching skills that waste tokens explaining basics like "what is a PDF" or generic advice like "write clean code". Treats skill design as knowledge engineering, not tutorial writing.

skills.sh installs
4.3K
GitHub stars
2.7K
last updated
Aug 21, 2026

Install

$ npx -y skills add softaworks/agent-toolkit --skill skill-judge --agent claude-code

Installs into .claude/skills of the current project.

Files

Skill Judge

Evaluate Agent Skills against official specifications and patterns derived from 17+ official examples.


Core Philosophy

What is a Skill?

A Skill is NOT a tutorial. A Skill is a knowledge externalization mechanism.

Traditional AI knowledge is locked in model parameters. To teach new capabilities:

Traditional: Collect data → GPU cluster → Train → Deploy new version
Cost: $10,000 - $1,000,000+
Timeline: Weeks to months

Skills change this:

Skill: Edit SKILL.md → Save → Takes effect on next invocation
Cost: $0
Timeline: Instant

This is the paradigm shift from "training AI" to "educating AI" — like a hot-swappable LoRA adapter that requires no training. You edit a Markdown file in natural language, and the model's behavior changes.

The Core Formula

Good Skill = Expert-only Knowledge − What Claude Already Knows

A Skill's value is measured by its knowledge delta — the gap between what it provides and what the model already knows.

Sponsors

Details

Repository
github.com/softaworks/agent-toolkit
Categories
Code Review & Quality, AI & Agent Building, Design & UI/UX

More from softaworks/agent-toolkit

All 43
1agricidaniel avatarads-planagricidaniel/claude-adsCreate a professional paid-advertising strategy covering objectives, economics, platform selection, campaign architecture, audiences, budget, creative, measurem4.2Kskills.sh installs
2softaworks avatarmarp-slidesoftaworks/agent-toolkitCreate professional Marp presentation slides with 7 beautiful themes (default, minimal, colorful, dark, gradient, tech, business). Use when users request slide 4.2Kskills.sh installs
3starchild-ai-agent avatarslide-creatorstarchild-ai-agent/official-skillsBuild 16:9 slide decks as HTML, exported to PDF (not PowerPoint format). Use when making a deck, presentation, or pitch (e.g. 10-slide pitch deck for X, trainin4.1Kskills.sh installs
4everyinc avatarce-brainstormeveryinc/compound-engineering-pluginExplore vague or ambitious ideas into a right-sized requirements-only unified plan. Use when the user wants to brainstorm, think through scope, decide what to b4.1Kskills.sh installs
5giuseppe-trisciuoglio avatarnextjs-app-routergiuseppe-trisciuoglio/developer-kitProvides patterns and code examples for building Next.js 16+ applications with App Router architecture. Use when creating projects with App Router, implementing4Kskills.sh installs
6zc277584121 avatarcontent-rewritezc277584121/marketing-skillsAdapt and rewrite content for different platforms (LinkedIn, X, Reddit, English blog, WeChat). Each platform has its own tone, format, and length requirements.4Kskills.sh installs