sensei

Improves skill frontmatter alignment via the Ralph loop and enforces a Medium-High score.

54|8|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/spboyer/sensei --skill sensei-spboyer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sensei
Source: https://github.com/spboyer/sensei/tree/main
Command: npx skills add https://github.com/spboyer/sensei --skill sensei-spboyer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Sensei addresses skill collisions by ensuring that Skill frontmatter includes explicit triggers and anti-triggers, a clear description, and proper routing information, enabling accurate skill invocation.

Core Features & Use Cases

  • Frontmatter scoring and iterative improvement using the Ralph loop: Read, Score, Scaffold, Improve, Verify, Tokens, Summary, Prompt, Repeat
  • Auto-generation of test scaffolds when tests are missing, alignment with references
  • Token budget analysis to keep SKILL.md concise and under limits

Quick Start

To begin, run sensei on a target skill to start the iterative frontmatter improvement loop.

Frequently Asked Questions about sensei

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate frontmatter compliance for skill files?

Frontmatter compliance is enforced by running an iterative Ralph loop that scores and improves SKILL.md files. It ensures explicit triggers, anti-triggers, and routing details are present to prevent skill invocation collisions.

What is the best way to keep skill documentation under token limits?

To keep skill documentation under token limits, use an automated token counting step during the improvement loop. It analyzes SKILL.md and references to ensure content remains concise and within budget.

How does the Ralph loop improve misaligned skill metadata?

The Ralph loop improves misaligned metadata by sequentially reading, scoring, scaffolding, and verifying files. It applies tests and scaffolding as needed to achieve a Medium-High compliance score.

Can I automatically generate test scaffolds for missing skill tests?

Yes, you can automatically generate test scaffolds when tests are missing. The automation aligns new tests with existing references to ensure proper validation during the improvement loop.

Why do I need explicit triggers and anti-triggers in skill frontmatter?

Explicit triggers and anti-triggers are needed to enable accurate skill invocation and prevent collisions. Without them, the system cannot properly route tasks to the correct skill.