author-skills

Reviews and authors SKILL.md files against a house rubric of structure, density, and failure-mode QA.

1|Updated Jul 13, 2026
One-click install
npx skills add https://github.com/dineshrevunuru/SuperSkills --skill author-skills-dineshrevunuru
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: author-skills
Source: https://github.com/dineshrevunuru/SuperSkills/tree/main/author-skills
Command: npx skills add https://github.com/dineshrevunuru/SuperSkills --skill author-skills-dineshrevunuru

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing or editing a SKILL.md without a shared rubric produces inconsistent, bloated, or no-op-filled skills that smaller models cannot reliably follow. This Skill encodes the authoring standard for an entire skill library so every SKILL.md is written, forked, and QA'd the same way. ## Core Features & Use Cases - House patterns and skeleton: Enforces named conventions (intake gate, mode-switchable paths, situational menus, reference-don't-restate) plus a standard frontmatter and section skeleton for every skill. - Failure-mode QA: Runs a five-mode lint pass (no-op, duplication, sediment, sprawl, premature completion) with a sentence-by-sentence no-op test and a structured QA report output. - Fork governance: Handles licensing attribution for forked skills and documents the deliberate rejection of the source rubric's anti-negation rule, keeping Don't/Do prohibition tables. - Use Case: When drafting a new skill for empty-state design, run the rubric to rewrite a vague description into trigger-rich phrasing, delete no-op sentences, replace restated taste values with a pointer to the design-taste skill, and ship with a checkable completion criterion. ## Quick Start Review this SKILL.md draft against the authoring rubric and run the full failure-mode QA with a verdict.

Frequently Asked Questions about author-skills

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

FAQPage Schema
How do I write a good SKILL.md description?

Front-load the skill's leading word and list one trigger per genuinely distinct branch, including quoted trigger phrases. Test whether a smaller model would know when to load the skill from the description alone; collapse synonym triggers as duplication.

What is the no-op test for skill instructions?

Read each sentence in isolation and ask whether the model behaves differently because that line exists. If not, delete the whole sentence rather than trimming words. Weak leading words like 'be thorough' are no-ops; replace them with stronger concrete terms.

When should I use the scrappy path versus the rigor path?

Use the scrappy lint pass for one-line edits or quick triage of an already-shipped skill. Use the full rigor path, including the complete failure-mode QA, for any new or forked skill entering the library, since it becomes permanent infrastructure.

Should I avoid negative prohibitions in prompt instructions?

This rubric deliberately keeps prohibitions as load-bearing guardrails for smaller models, rejecting the source rule that bans negation. Keep Don't/Do tables where every prohibition is paired with its positive alternative; prefer positive phrasing only inside prose steps.

Why does my skill duplicate taste or evidence rules from other skills?

Restated values drift across copies, which is the failure the library exists to prevent. Replace any restated taste, evidence, or bias content with a pointer such as 'load design-taste first' so a single source of truth owns each value.

How long should a SKILL.md file be?

Keep the body between 120 and 350 lines with at least one complete worked example. If content exceeds the limit, move reference material into a references file behind a context pointer rather than deleting live, unique content.