skills.rest
thesyntaxninja
thesyntaxninjaCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

writing-skills

Create SKILL.md and PATTERN.md files with CSO lint and index registration.

2|Updated Mar 4, 2026
Search Tags:#templates#guidelines#registration#skill-authoring#skill-index#pattern-writing#cso-lint
One-click install
npx skills add https://github.com/thesyntaxninja/syntaxninja-dojo --skill writing-skills-thesyntaxninja
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/thesyntaxninja/syntaxninja-dojo/tree/main/skills/writing-skills
Command: npx skills add https://github.com/thesyntaxninja/syntaxninja-dojo --skill writing-skills-thesyntaxninja

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a precise authoring guide and validation checklist to eliminate inconsistent or invalid SKILL.md and PATTERN.md files, preventing broken or unregistered skills in the Dojo index.

Core Features & Use Cases

  • Authoring template: Exact frontmatter structure and required sections for new skills and patterns.
  • Linting rules: Clear CSO lint expectations for description length, naming conventions, and required fields.
  • Registration workflow: Instructions for placing files, optional supporting directories, and running the index builder to register skills.
  • Use Case: When a developer or contributor needs to formalize a learned behavior into a discoverable Skill or Pattern that integrates with the Dojo.

Quick Start

Use the writing-skills skill to create a new SKILL.md with the required frontmatter, follow the prescribed sections, and run CSO lint before registering in the index.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I write a valid SKILL.md file for the Dojo index?▼

To write a valid SKILL.md file, use the exact frontmatter structure and required sections defined by the authoring template, ensuring strict naming conventions and field completeness before registration.

What does the CSO lint check for when validating skill files?▼

The CSO lint checks SKILL.md and PATTERN.md files for description length, naming conventions, and required frontmatter fields to prevent broken or unregistered skills from entering the Dojo index.

How do I register a new skill or pattern in the index?▼

To register a new skill or pattern, place the validated SKILL.md or PATTERN.md file in the correct directory and run the index builder to make it discoverable in the Dojo.

When do I need to use a PATTERN.md file instead of SKILL.md?▼

You need to use a PATTERN.md file when formalizing a learned behavior into a discoverable pattern rather than a distinct skill, following the same frontmatter rules and registration workflow.

Why are my Dojo skills not showing up in the index after creation?▼

Dojo skills fail to appear in the index when SKILL.md files have invalid frontmatter or missing required sections, which the CSO lint catches before the registration workflow accepts them.

Can I use custom directories when authoring Dojo skills?▼

Yes, the registration workflow supports optional supporting directories alongside your SKILL.md file, allowing you to organize skill components while maintaining strict frontmatter validation.

Related Skills

Explore More Software Engineering Skills→
shariqazeemshariqazeem
1

dojo-init

Initialize Dojo projects with configuration files, example systems, and tests.

Community
Intermediate
williamzujkowskiwilliamzujkowski
6

Create a New Skill from Topic

Generate a SKILL.md with frontmatter, sections, examples, and tests from a topic.

Community
Advanced
AnandaAnugrahHandyantoAnandaAnugrahHandyanto

savarez-agent-skill-authoring

Validate in-repo SKILL.md files for frontmatter and structure.

Community
Intermediate
RyderFreeman4LogosRyderFreeman4Logos
12

pattern-creator

Scaffold CSA patterns with PATTERN.md, SKILL.md, and workflow.toml files.

Community
Advanced