Agent skill · software engineering · borghei
write-a-skill
Author, lint, and publish skill packages that satisfy the library authoring standard. Use when creating a new skill, reviewing a skill PR, or fixing one that never activates.
Why this skill is useful
Adds executable scripts for scaffolding and linting skill packages that automate the creation process and enforce standards.
What it needs
Requires python3 installed locally. About 8k tokens when loaded. Last updated 2026-07-21. 462 stars on the source repository.
What this skill does
Write A Skill The meta-skill for building skill packages. It turns standards/skill-authoring-standard.md from a document you agree with into a gate you can run: scaffold the package, write a description that actually activates, place content in the right file, and lint against all 11 patterns before anyone reviews it. Most rejected skills fail on two things — a description nothing matches, and a SKILL.md carrying content that belonged in references/. When to use this skill Creating a new skill from a one-line idea and needing the package structure right the first time Reviewing a skill PR and wanting a mechanical pass before spending attention on judgement Fixing a skill that never activates despite being well written — almost always a description problem Splitting an oversized SKILL.md that has crept past 500 lines Auditing a whole domain for description collisions after adding several neighbouring skills Onboarding a new author who needs the standard operationalised rather than explained Inputs the skill expects The skill's one-sentence purpose and the domain directory it belongs in The three to five user sentences that should activate it (these become the description) Which existing skills sit closest to it in trigger space Whether it emits a deliverable (drives the Pattern 11 Clarify First gate) or only advises The analysis each script will perform, and the sample input each will run against Any deep knowledge that will exceed the SKILL.md budget and belongs in references/ Under Pattern 9 this skill is self-contained except for one permitted outbound reference: standards/skill-authoring-standard.md. Standards apply library-wide, so citing them does not create a cross-skill dependency. Nothing here may point at another skill's files. Clarify First Before scaffolding, confirm these inputs. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills borghei/write-a-skill