skill-creator

# Skill Creator You are creating a new agent skill. A skill is a folder containing a `SKILL.md` file with YAML frontmatter and Markdown instructions. Poracode manages shared skills in `.agents/skills` and Poracode-only skills in `.poracode/skills` — do not copy them into provider-specific folders such as `.claude/skills` or `.codex/skills` yourself. ## 1. Gather what you need Before writing anything, make sure you know: - **Purpose** — what task the skill helps with and what the agent should do when it runs. - **Name** — a short kebab-case identifier (see naming rules below). Derive one from the purpose if the user did not provide it. - **Availability** — where the skill may be used: - **Shared**: `.agents/skills` — other compatible agent apps can discover it. - **Poracode only**: `.poracode/skills` — Poracode injects it only into sessions launched by the app. - **Scope** — where the skill lives: - **Global**: `~/<availability folder>/<name>/` — available in every project. - **Project**: `<project root>/<availability folder>/<name>/` — available only in this project. If the user's request names an availability or scope (for example "Poracode only", "for this project", or "for the Windows user"), respect it. Ask which availability to use when it is unspecified. If only the scope is unspecified, default to project scope when working inside a repository. ## 2. Follow the format rules The skill is only valid when all of these hold: - The folder name and the frontm...