Skip to main content
Skills are tenant-owned procedures written in Markdown. Attach them to agents to provide reusable instructions without duplicating those instructions across agent configurations.
All endpoints are [User+Key]. Reads require skills:read; writes require skills:write. For user sessions, write operations are available to owner, billing_admin, and developer.

​
Endpoints

MethodPathDescriptionAuth
GET/skills?tenant_id=List tenant-authored skills[User+Key] skills:read
POST/skillsCreate a skill[User+Key] skills:write
GET/skills/catalog?tenant_id=List catalog templates[User+Key] skills:read
POST/skills/catalog/:id/favoriteFavorite a catalog template[User+Key] skills:write
DELETE/skills/catalog/:id/favorite?tenant_id=Remove a favorite[User+Key] skills:write
POST/skills/catalog/:id/installInstall a catalog template[User+Key] skills:write
GET/skills/:id?tenant_id=Get a skill[User+Key] skills:read
PATCH/skills/:id?tenant_id=Update a skill[User+Key] skills:write
DELETE/skills/:id?tenant_id=Archive a skill[User+Key] skills:write

​
Attachment modes

Agents reference skills by ID and resolve the current skill content each time they run. Editing a skill therefore affects later runs without creating a new agent version.
ModeBehavior
alwaysThe full skill instructions are included in every run. Use this for procedures the agent must follow consistently.
autoThe agent sees the skill’s name and description, then loads the full instructions only when the current task matches. Use this to keep unrelated instructions out of the prompt.
See Configuring agents for the attached_skills shape and runtime behavior.

​
List skills

GET /skills
​
tenant_id
string
required
Tenant whose active skills to list.
curl "https://api.autosage.ai/api/v1/skills?tenant_id=TENANT_ID" \
  -H "Authorization: Bearer $AUTOSAGE_KEY"

​
Create a skill

POST /skills
​
tenant_id
string
required
Tenant that will own the skill.
​
name
string
required
Skill name, up to 255 characters.
​
description
string
required
Short matching description, up to 280 characters. Make it specific enough for an agent to decide when an auto skill applies.
​
body
string
required
Markdown instructions the agent follows when the skill is loaded.
curl -X POST "https://api.autosage.ai/api/v1/skills" \
  -H "Authorization: Bearer $AUTOSAGE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tenant_id": "TENANT_ID",
    "name": "Escalate urgent tickets",
    "description": "Classify urgent support requests and prepare an escalation summary.",
    "body": "## Procedure\n1. Confirm the impact.\n2. Collect reproduction details.\n3. Produce an escalation summary."
  }'

​
Get a skill

GET /skills/:id
​
id
string
required
Skill ID.
​
tenant_id
string
required
Tenant that owns the skill.

​
Update a skill

PATCH /skills/:id Updates any supplied name, description, or body field.
​
id
string
required
Skill ID.
​
tenant_id
string
required
Tenant that owns the skill.
Attached agents use the latest saved content on their next run. Review high-impact edits carefully because no separate agent update is required.

​
Archive a skill

DELETE /skills/:id Archives the skill rather than returning it in the active library.
​
id
string
required
Skill ID.
​
tenant_id
string
required
Tenant that owns the skill.

​
Skill catalog

​
List catalog templates

GET /skills/catalog Returns active templates together with their version, favorite state, and installed skill ID for the tenant.
​
tenant_id
string
required
Tenant context used for favorite and installation state.

​
Favorite a template

POST /skills/catalog/:id/favorite
​
id
string
required
Catalog template ID.
​
tenant_id
string
required
Tenant that will favorite the template.

​
Remove a favorite

DELETE /skills/catalog/:id/favorite
​
id
string
required
Catalog template ID.
​
tenant_id
string
required
Tenant whose favorite to remove.

​
Install a template

POST /skills/catalog/:id/install Creates an editable tenant skill from the catalog template. Reinstalling an already-installed template returns the existing skill; reinstalling an archived template reactivates it.
​
id
string
required
Catalog template ID.
​
tenant_id
string
required
Tenant that will own the installed skill.
curl -X POST "https://api.autosage.ai/api/v1/skills/catalog/TEMPLATE_ID/install" \
  -H "Authorization: Bearer $AUTOSAGE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "tenant_id": "TENANT_ID" }'

​
Next steps

Configure agents

Attach skills in always or auto mode.

API keys

Grant skills:read and skills:write safely.

Tenants

Understand the ownership boundary for skills.