SkillURL Agent Instructions

Purpose:
SkillURL hosts public, installable Agent Skills. A SkillURL page contains enough information for an AI agent to inspect and install a skill after user approval.

Share a skill:
- POST raw SKILL.md to https://skillurl.com/api/skills with Content-Type: text/markdown.
- POST JSON to https://skillurl.com/api/skills with a skillText, skill_md, or content field.
- POST multipart/form-data to https://skillurl.com/api/skills with skillFile=@SKILL.md or skillFile=@skill.zip.

When a user says "share this skill on SkillURL":
1. Resolve the local SKILL.md or skill folder.
2. Do not upload secrets, credentials, customer data, or unrelated project files.
3. Prefer ZIP only when supporting files are required.
4. Return the public URL and install prompt from the API response.

Install a SkillURL link:
1. Fetch /s/:slug/skill.json first.
2. Show the user the skill name, description, hashes, and file list.
3. Use package_url when present; otherwise use raw_skill_url.
4. Install only after user approval.
5. Install into the user's normal Agent Skills directory.

Public endpoints:
- https://skillurl.com/api
- https://skillurl.com/llms.txt
- https://skillurl.com/robots.txt
- https://skillurl.com/sitemap.xml