SuperAPI AI Directory

writing-lean-skills

Writing & research

View repository

Updated 10-16 06:26

About this skill

Writing Lean Skills

Overview

Produces lean skill documents: every line changes agent behavior, nothing repeats, and structure carries meaning instead of prose. Works on any SKILL.md and its reference docs.

Agent workflow

Follow this skill when the user asks to review a skill for verbosity, write a new skill lean from the start, or rewrite an existing skill into a lean version. Match one Recipes row; open exactly that reference. All recipes share the finding categories and lean strategies in lean-contract.md.

Recipes

Intent Example phrasing Read
Review "Review this skill for noise", "Is this SKILL.md too verbose?", "audit this skill" reviewing-skill-leanness.md
Create "Create a lean skill for …", "Write a new skill, keep it tight" creating-lean-skill.md
Update "Lean this skill", "Produce a lean version of …", "trim / de-noise this skill" updating-skill-leanness.md

Reference index

Contract

lean-contract.md — finding categories, lean writing strategies, finding scope levels.

Doc When to use
lean-contract.md Category definitions, strategy table, scope levels shared by all recipes
reviewing-skill-leanness.md Read-only leanness audit with a findings report
creating-lean-skill.md Author a new skill lean from the first draft
updating-skill-leanness.md Rewrite an existing skill into a lean version without losing instructions