skills.rest
bordenet
bordenetCOMMUNITY
Explore all skills by this author →
GitHub

writing-skills

Validate SKILL.md files for frontmatter, prose, and Markdown compliance.

8|1|Updated Jan 24, 2026
Search Tags:#documentation#markdown#review#frontmatter#style-guide#skill-authoring#prose-quality
One-click install
npx skills add https://github.com/bordenet/superpowers-plus --skill writing-skills-bordenet
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/bordenet/superpowers-plus/tree/main/skills/writing/writing-skills
Command: npx skills add https://github.com/bordenet/superpowers-plus --skill writing-skills-bordenet

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents inconsistent, unclear, or non-compliant SKILL.md files by providing concrete checks and a creation checklist so skills are discoverable, concise, and actionable.

Core Features & Use Cases

  • Frontmatter validation: Confirms required fields (name, description) and recommended keys, plus trigger/anti-trigger conventions for discoverability.
  • Prose and Markdown quality: Enforces checklist-style procedures, discourages narrative fluff, enforces line limits and token-budget guidance.
  • Creation Checklist & Failure Modes: Guides test-first authoring, verification steps, and concrete fixes for common structural and content failures.
  • Use Case: Run during authoring, code review, or pre-commit hooks to catch formatting, discoverability, and procedural gaps before publishing a skill.

Quick Start

Review this SKILL.md for prose quality, Markdown formatting, and frontmatter compliance and produce a concise prose-quality checklist with violations and remediation steps.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I validate SKILL.md frontmatter fields and trigger conventions?▼

Validate SKILL.md frontmatter by confirming required name and description fields alongside recommended keys, then checking trigger and anti-trigger conventions to ensure skill discoverability and compliance.

What is the best way to review markdown prose quality in skill authoring?▼

Review markdown prose quality by enforcing checklist-style procedures, discouraging narrative fluff, and checking line limits and token-budget guidance to keep skill documentation concise and actionable.

Can I use a style-guide checklist for pre-commit checks on documentation?▼

Yes, you can run a style-guide checklist during pre-commit hooks to catch formatting, discoverability, and procedural gaps in documentation, ensuring files meet structural and prose-quality standards before publishing.

How do I fix common failure modes in SKILL.md files?▼

Fix common SKILL.md failure modes by applying concrete remediation steps from a creation checklist, which guides test-first authoring and verification to resolve structural and content violations.

Why does my skill documentation fail repository audits for prose quality?▼

Documentation fails repository audits when it contains narrative fluff, lacks checklist-style procedures, exceeds line limits, or misses required frontmatter fields and trigger conventions for discoverability.

Related Skills

Explore More Content & Communication Skills→
vignesh2027vignesh2027
6

template-skill

Generate a standardized SKILL.md skeleton with required frontmatter fields.

Community
Basic
dvy1987dvy1987
3

publish-skill

Package and publish validated agent skills to skills.sh and GitHub.

Community
Advanced
recca0120recca0120
11

engineering-quality

Configure Biome and Lefthook for linting, formatting, and git hook enforcement.

Community
Intermediate
sachinnair90sachinnair90

docs-standards

Standardize Markdown documentation to match Microsoft Style Guide and squad rules.

Community
Basic