🥋
Sensei
Stop skill collisions.
Ship better agents.
Iteratively improve skill frontmatter compliance using the Ralph loop pattern.
npx skills add spboyer/sensei Skills Without Frontmatter Break Things
Poor frontmatter leads to skill collision — agents invoking the wrong skill for a given prompt.
No triggers
Agent doesn't know when to activate the skill.
No anti-triggers
Agent doesn't know when NOT to use the skill.
Brief descriptions
Not enough context for accurate matching.
Token bloat
Oversized skills waste context window.
The Ralph Loop
Six steps, repeated until your skill reaches Medium-High compliance.
Read
Load skill state and count tokens
Score
Evaluate frontmatter compliance
Improve
Add triggers and anti-triggers
Verify
Run tests to confirm changes
Check
Analyze token usage and budget
Summary
Display before/after results
Before & After
From vague to precise — a single pass through the Ralph loop.
---
name: pdf-processor
description: 'Process PDF files for various tasks'
------
name: pdf-processor
description: |
Process PDF files including text extraction,
rotation, and merging.
USE FOR: "extract PDF text", "rotate PDF",
"merge PDFs", "split PDF", "PDF to text",
"combine PDF files".
DO NOT USE FOR: creating new PDFs
(use document-creator), extracting images
(use image-extractor), or OCR on scanned
documents (use ocr-processor).
---Scoring Levels
Sensei targets Medium-High — the sweet spot between completeness and token efficiency.
Low
No triggers, short description
Medium
Has triggers, missing anti-triggers
Medium-High
Triggers + anti-triggers present
← TargetHigh
Full routing clarity with INVOKES
Quick Start
One command to install. Three ways to run.
npx skills add spboyer/sensei Run sensei on my-skill-name Improve a single skill Run sensei on my-skill-name --fast Skip tests for faster iteration Run sensei on all skills Batch-improve every skill in your project