write-a-skill

name	write-a-skill
description	Authoring guide for CLI-native skill files and meta skills in agent-infra. Use when creating or updating grouped markdown skills, ref pages, reorganizing skill trees, or onboarding contributors.
metadata	{"version":"2.0","category":"meta-tooling","output_artifacts":["skill_file.md"],"skills":["domain-discovery","tree-generator"]}

Writing Skills for agent-infra

This repo is skills-only. Skills are the single source of guidance. They must be short, concrete, and optimized for agent use.

Module Types

Type	Directory	Purpose
Skill	skills/	Task playbooks and reference knowledge
Agent	agents/	Heuristics for what “good” looks like (optional)
Meta	meta/	Tooling for generating and maintaining skills

Avoid duplicating guidance across files. Each skill owns one concern.

---

Internal Skills (skills/)

Internal skills use grouped markdown files that the ladybluenotes CLI discovers. Do not create SKILL.md router pages for this repo; use names, descriptions, aliases, tags, depth, and ref/ pages so the CLI can choose the right file.

File Tree

skills/
  tooling/
    vitest/
      basics.md
      config.md
      ref/
        mocking.md
        environments.md
  preferences/
    tooling.md
    ref/
      package-manager.md

Use for deep material that should load only when a prompt needs it. Use ordinary files for primary task pages.