manage-skills

manage-skills Skill

L0: One-line Summary

Manage the full lifecycle of Skills—import, author, install, update, and delete.

L1: Overview and Use Cases

Capability

manage-skills is a Meta-Skill that gives DesireCore the ability to manage the Skill system. It covers five core operations:

1. Import a Skill from a URL — supply a remote SKILL.md URL, fetch the content, and create
2. Bulk import from a Git repository — clone a Git repo, scan all SKILL.md files, and selectively import
3. Manage existing Skills via API — list, read, update, delete, enable/disable Skills
4. Author SKILL.md directly via AgentFS — use the Write/Edit tools to create Skills on the filesystem
5. Bulk operations and cross-Agent copying — bulk enable/disable/delete, plus copy Skills to other Agents

Use Cases

• The user wants to import community-shared Skills from platforms like GitHub
• The user wants to install a new Skill on an Agent to enhance its capabilities
• The user needs to author a custom Skill to teach the Agent a new workflow
• The user wants to bulk-manage existing Skills (enable/disable/delete)
• The user wants to copy one Agent's Skill to another Agent
• The user needs to view or edit the contents of a Skill

Core Value

• Self-extension: an Agent can autonomously expand its capability boundary by importing or authoring Skills
• Governable: every Skill change goes through the API or filesystem operations and is traceable and auditable
• Flexibility: supports both API import and direct filesystem authoring to fit different scenarios

L2: Detailed Specification

1. Import a Single Skill from a URL

For importing a single SKILL.md file (e.g. a GitHub raw link).

Step 1: Fetch the remote content

POST /api/skills/fetch-url
Content-Type: application/json

{
  "url": "https://raw.githubusercontent.com/user/repo/main/my-skill/SKILL.md"
}

Success response (200 OK):

{
  "content": "---\nname: My Skill\ndescription: ...\n---\n\n# Skill content..."
}