create_skill
Create a skill with SKILL.md and supporting files, or customize a built-in by extending it, enabling progressive disclosure for reference docs and runnable data scripts.
Instructions
Create a new editable skill (a SKILL.md + optional reference/data files come later via update_skill).
Use this to author a skill from Claude, or to CUSTOMIZE a built-in (pass
extends="<builtin_skill_id>" and the built-in's body is seeded for you).
FILE LAYOUT (a skill is SKILL.md + supporting files — progressive disclosure):
- SKILL.md the always-loaded contract: workflow + definition-of-done.
Keep it lean; link to the files below, don't inline them.
- reference/*.md docs the agent READS on demand (style guides, pipelines).
- data/* assets the skill carries, including RUNNABLE scripts
(e.g. data/verify_row.py — a checker the agent reads and
EXECUTES as a gate). Put scripts and data files here, NOT
under reference/, so get_skill surfaces them as runnable.
Args:
name: Skill name (becomes the slug). Required.
skill_markdown: The SKILL.md contents (frontmatter + workflow). Required
unless `extends` is given (then it's seeded from the built-in, but you
may override).
description: Short description (else taken from frontmatter).
category: Category label (e.g. "seo", "content").
scope: "user" (private to you) or "project" (shared with collaborators).
project_id: Required when scope="project".
extends: A built-in skill_id to copy as the starting point (Customize).
visibility: "private" | "project" | "public".
verbatim_source: When PORTING an existing document, pass the original text
here. The store runs a coverage-based fidelity check and returns a
report — a FAIL means content was SILENTLY CONDENSED (do not report
"done"; re-port the missing segments). Splitting + intentional edits
are allowed. Call author_skill() first for the full authoring guide.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| scope | No | user | |
| config | No | ||
| extends | No | ||
| category | No | ||
| project_id | No | ||
| visibility | No | private | |
| description | No | ||
| skill_markdown | Yes | ||
| verbatim_source | No |