← ClaudeAtlas

create-team-skilllisted

Authoring guide for creating a new skill in this plugin, matching the conventions the existing skills already use. Establishes the principle-or-not classification (Part 0) and the three decisions every skill must make before any prose is written: how it is invoked (entry point vs building block), how it acquires its input, and how it manages the context window. Do NOT hand-write a SKILL.md directly. Trigger on "create a skill", "add a new skill", "scaffold a skill", "write a SKILL.md", or a description of new skill functionality the user wants to build.
bostonaholic/team · ★ 11 · AI & Automation · score 72
Install: claude install-skill bostonaholic/team
# Creating a new Team skill This is the dev-workspace guide for authoring a skill in this plugin. Follow it so a new skill matches the conventions the existing skills already use. A skill is a document the agent reads, not a function it calls. Before writing one, classify it — principle skill or not (Part 0) — then make three decisions in order. Each has a wrong-by-default failure mode, so decide deliberately rather than copying another skill's wiring. 1. **Invocation** — is this an entry point (user/model triggers it) or a building block (another skill composes it)? This defines what the skill *is*. 2. **Input** — how does it get the thing it operates on? Discover it. Do not demand it. 3. **Context** — how does it stay inside the window while it runs? Offload, delegate, search. ## Shared convention: the artifacts directory Every skill that hands off uses one durable, repo-local directory for what it would otherwise "keep in the conversation". That covers inputs passed between skills, checkpoints, and findings. In this repo that directory is **`docs/plans/<id>/`**, where `<id>` is `<TICKET>-<topic>` or `<YYYY-MM-DD>-<topic>`. This guide calls it `<ARTIFACTS>`. Producers write there. Consumers discover and read from there. The agreement matters more than the path: every handoff uses the same convention so skills stay decoupled. --- ## Part 0 — Principle skill or not Decide this before Part 1: the verdict fixes the name, the shape, and the frontmatter. A `princip