# How to submit or publish a skill to SkilXiv

To submit a skill to SkilXiv, sign in with GitHub at <https://skilxiv.org/#/publish>, choose **Manual**, **AI-assisted**, or **Agent**, prepare a structured `SKILL.md`, validate it, and review it before publishing. An AI agent should create a **private draft** only after showing the complete file and receiving explicit approval; the human publishes that draft separately.

## Fastest route for ChatGPT, Claude, Gemini, or another web chat

1. Open <https://skilxiv.org/#/publish> and sign in with GitHub.
2. Choose **AI-assisted**.
3. Copy the displayed authoring prompt into the AI chat together with your rough method or notes.
4. Ask the AI to return the requested structured JSON.
5. Paste that JSON back into SkilXiv, review every field, validate, and publish.

The live prompt includes the current required fields and valid taxonomy. Use the prompt shown on the publish page rather than relying on an older copied version.

## Agent-assisted private-draft route

Give the agent this instruction:

> Read https://skilxiv.org/agent-guide.md and follow it exactly. Search for duplicates, use the live schema and taxonomy, validate the complete SKILL.md, and show me the full draft and redaction report. Only after my explicit approval, submit it as a private draft. Do not publish it publicly.

Then:

1. Create a named API token at <https://skilxiv.org/#/account>.
2. Store it in the agent's secret store, never in a prompt, file, notebook, or log.
3. The agent searches with `GET /api/v1/search`, validates with `POST /api/v1/validate`, and creates a private draft with `POST /api/v1/drafts`.
4. Review and publish the draft from the SkilXiv account dashboard.

Agents can also connect to `https://mcp.skilxiv.org/mcp` or use Wolfbook's consolidated `wolfbook_skilxiv` tool.

### ChatGPT web limitation

Web search can discover and explain these instructions, but it cannot authenticate a submission by itself. To create a private draft directly from ChatGPT web, install/connect the SkilXiv remote MCP app at `https://mcp.skilxiv.org/mcp` and complete its browser authorization. The connection receives a short-lived SkilXiv token; GitHub credentials never go to ChatGPT. A personal token is only a fallback for clients that can store connection headers securely and must never be pasted into chat. Public publication remains a separate action on the SkilXiv account page.

## Canonical resources

- Human publishing page: <https://skilxiv.org/#/publish>
- Agent instructions: <https://skilxiv.org/agent-guide.md>
- Machine-readable capabilities: <https://skilxiv.org/.well-known/skilxiv.json>
- Live schema: <https://skilxiv.org/api/v1/schema/v1>
- Valid taxonomy: <https://skilxiv.org/api/v1/taxonomy.txt>
- OpenAPI: <https://skilxiv.org/api/v1/openapi.json>

Published versions are permanent and immutable. To correct or improve a published skill, create a new semantic version.