菜单
Upload a Claude Code skill to the Anthropic Skills API for workspace-wide availability. Analyzes the skill, bundles dependencies, transforms frontmatter, validates, and uploads. Tracks uploads for future updates. Trigger phrases: "upload to API", "publish skill", "sync to API", "upload skill".
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | arcana-upload-api |
| description | Upload a Claude Code skill to the Anthropic Skills API for workspace-wide availability. Analyzes the skill, bundles dependencies, transforms frontmatter, validates, and uploads. Tracks uploads for future updates. Trigger phrases: "upload to API", "publish skill", "sync to API", "upload skill". |
Upload a Claude Code skill to the Anthropic Skills API.
{PLUGIN_ROOT} = This plugin's root directory (where plugin.json lives)
ANTHROPIC_API_KEY environment variable must be setrequests and pyyaml packagesVerify API key is set:
if [ -z "$ANTHROPIC_API_KEY" ]; then
echo "ANTHROPIC_API_KEY not set"
fi
If not set, ask user to set it.
Read {PLUGIN_ROOT}/lib/patterns/state-tracking.md for guidance.
Check if this skill has been uploaded before:
python3 "{PLUGIN_ROOT}/lib/tools/state.py" get {skill-name}
If found:
If not found:
Same as export-zip - read {PLUGIN_ROOT}/lib/patterns/skill-analysis.md.
Same as export-zip - read {PLUGIN_ROOT}/lib/patterns/frontmatter-transform.md.
Strip CC-only fields, keep name/description/version.
Same as export-zip - read {PLUGIN_ROOT}/lib/references/validation-rules.md.
Validate name and description.
Same as export-zip:
python3 "{PLUGIN_ROOT}/lib/tools/zip_skill.py" \
--name {skill-name} \
--output /tmp/{skill-name}.zip \
--base-path {temp-directory} \
{files...}
Read {PLUGIN_ROOT}/lib/references/api-spec.md for API details.
For new skill:
python3 "{PLUGIN_ROOT}/lib/tools/api.py" upload /tmp/{skill-name}.zip \
--title "{Skill Title}"
For existing skill (new version):
python3 "{PLUGIN_ROOT}/lib/tools/api.py" version {skill_id} /tmp/{skill-name}.zip
Record the upload:
python3 "{PLUGIN_ROOT}/lib/tools/state.py" set {skill-name} \
--skill-id {skill_id} \
--source-path {original-skill-path}
New skill:
Upload complete!
Skill: my-skill
ID: skill_01AbCdEfGhIjKlMnOpQrStUv
Version: 1
Status: Created
To use in Messages API:
{
"container": {
"skills": [
{
"type": "custom",
"skill_id": "skill_01AbCdEfGhIjKlMnOpQrStUv",
"version": "latest"
}
]
}
}
Updated skill:
Upload complete!
Skill: my-skill
ID: skill_01AbCdEfGhIjKlMnOpQrStUv
Version: 3 (updated from v2)
Status: New version created
The latest version is now active for "version": "latest"
User: Upload the github-helper skill to the API
Claude:
/path/to/github-helper/SKILL.md...python3 lib/tools/api.py upload /tmp/github-helper.zip --title "GitHub Helper"
{
"id": "skill_01AbCdEfGhIjKlMnOpQrStUv",
"title": "GitHub Helper",
"version": 1
}
Upload complete!
| Error | Resolution |
|---|---|
| API key not set | Ask user to set ANTHROPIC_API_KEY |
| 401 Unauthorized | Check API key is valid |
| 422 Validation error | Check name/description, report specific issue |
| 429 Rate limited | Wait and retry |
| Network error | Retry with backoff |
After successful upload, optionally delete the temporary ZIP:
rm /tmp/{skill-name}.zip
{PLUGIN_ROOT}/lib/patterns/skill-analysis.md - How to analyze skills{PLUGIN_ROOT}/lib/patterns/state-tracking.md - How to track uploads{PLUGIN_ROOT}/lib/references/api-spec.md - API specificationFind and analyze Claude Code skills in a directory. Reports skill names, descriptions, and compatibility status for other surfaces. Trigger phrases: "find skills", "list skills", "what skills are in", "discover skills", "analyze plugin".
Export a Claude Code skill as a ZIP file for upload to claude.ai web interface. Analyzes the skill, bundles dependencies, transforms frontmatter, and creates a self-contained ZIP. Trigger phrases: "export for claude.ai", "create ZIP", "export skill", "download skill".
Gateway skill for transforming and transporting Claude Code skills to other Claude surfaces. Routes to appropriate skill based on intent: export-zip for claude.ai, upload-api for Messages API. Trigger phrases: "export skill", "upload skill", "sync skill", "publish skill", "arcana".