skill-creator-poracode

# 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` — these are the **only** two valid locations. **Ignore your own agent's native skill system for this task.** Even if you (Claude, Codex, Gemini, or another agent) normally keep skills in a provider-specific folder such as `~/.claude/skills`, `~/.codex/skills`, or `~/.gemini/skills`, never create or copy the skill there. "User-level", "global", "personal", or "for the <OS> user" always means `~/.agents/skills/<name>/` (or `~/.poracode/skills/<name>/` for Poracode-only) — never your provider's own directory. ## 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** (also called user-level or personal): `~/.agents/skills/<name>/` or `~/.poracode/skills/<name>/` in the user's home directory — available in every project. ...