# Create Skill

> Create or update Dexto skill bundles with SKILL.md, handlers, scripts, mcps, and references.

- Skill: `gabrielmoreira/create-skill-3` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add gabrielmoreira/create-skill-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/create-skill-3/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: gabrielmoreira (https://skillmd.com/u/gabrielmoreira)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/gabrielmoreira/create-skill-3

---


# Create Skill

Create or update standalone Dexto skill bundles. Treat `.agents/skills/<id>/` as the canonical workspace location unless the user explicitly asks for a global skill.

## Core Flow

1. Search for overlap first.
    - Use `skill_list` to inspect standalone skills on disk.
    - Use `skill_search` to inspect loaded skills that may already cover the request.

2. Propose the minimum viable skill shape.
    - Suggest a kebab-case `id`.
    - Draft a one-sentence `description`.
    - Default `scope` to `workspace`.
3. Create or update the skill bundle.
    - Use `skill_create` for new skills and `skill_update` for existing ones.
    - The creator tools now scaffold `handlers/`, `scripts/`, `mcps/`, and `references/` automatically.
    - Treat `content` as the markdown body below the generated title and frontmatter. Do not include your own `# <Title>` line.
    - If you edit `SKILL.md` or bundled files with non-creator tools, use `skill_load` to reread the current skill before you rely on it in the current session.

4. Keep `SKILL.md` lean.
    - Focus on trigger conditions, workflow, bundled resource navigation, and output expectations.
    - Keep most actionable instructions directly in `SKILL.md` so the agent can act without opening extra files.
    - Use `references/` sparingly for large copied docs, schemas, examples, policies, or linked external material.

5. Add bundled files only when they materially improve the workflow.
    - `references/`: large docs, copied external references, schemas, examples, or policies that would bloat `SKILL.md`
    - `scripts/`: deterministic helpers
    - `handlers/`: reusable workflow logic or helper code
    - `mcps/`: MCP configs the skill should carry with it
    - When a skill needs a real bundled MCP server, prefer the SDK-based stdio pattern in `references/mcp-server-pattern.md`.

6. Reuse before duplicating.
    - Extend nearby skills or references when the problem is already mostly solved.
    - If borrowing a pattern from another skill, adapt it instead of copying large blocks blindly.

7. Be precise about MCP status.
    - Creating `mcps/*.json` only creates bundled MCP config.
    - Do not say you created a real MCP server unless the config points at a bundled runnable implementation or a verified external command/package.
    - If the user asked for a real MCP and you only scaffolded config, say that clearly and keep going until the server exists or the user redirects you.
    - For real bundled MCPs, prefer the official `@modelcontextprotocol/sdk` server APIs with `StdioServerTransport`. Avoid hand-rolled Content-Length framing unless the user explicitly asks for low-level protocol code.

## SKILL.md Structure

- `## Purpose`
- `## When To Use`
- `## Workflow`
- `## Bundled Resources`
- `## Output Format`

## Notes

- Read `references/skill-anatomy.md` when you need the bundle layout or packaging checklist.
- Read `references/mcp-server-pattern.md` when the skill needs a bundled MCP server implementation.
- If you add MCP config files under `mcps/`, use `skill_load` after the edit so the running session rereads the current skill metadata. Configure runtime MCP servers through the normal MCP configuration path.
- If the user asked for a working MCP-backed skill, verify the configured MCP server and load the skill with `skill_load` before relying on it.
- If the user asks which tools can be referenced, use `tool_catalog`.