skild

skild

skild is the package manager for Agent Skills — like npm, but for AI agents.

When to Use

Use this skill when:

• Installing new capabilities for AI agents
• Managing installed Skills (list, update, uninstall)
• Publishing Skills to share with the community
• Searching or discovering new Skills

Agent Search & Discovery (Skild Index)

When an agent needs to find Skills from the Skild index (registry + linked + auto catalog), use the Registry API:

# Unified discovery (registry + linked skills)
curl "https://registry.skild.sh/discover?q=<query>&limit=20"

# Resolve a short alias (optional)
curl "https://registry.skild.sh/resolve?alias=<alias>"

Notes:

• Prefer alias if present; it provides the shortest install command.
• Use the returned install string directly (quotes may appear when a #ref is required).
• If you need to browse linked items only:
  • https://registry.skild.sh/linked-items?limit=20
• CLI skild search uses the same unified index.

Agent Workflow (Recommended)

1. Search via /discover and shortlist results by description/tags.
2. Confirm with the user and pick the best match.
3. Install using the provided install command (or alias).
4. Manage using skild list / info / update / uninstall / sync.

Prerequisites

Node.js ≥18 is required.

npm install -g skild

Core Commands

Install a Skill

# From GitHub (shorthand)
skild install owner/repo/path/to/skill

# From registry
skild install @publisher/skill-name

# From local directory
skild install ./my-skill

List Installed Skills

skild list

Output groups Skills by type: Skillsets, Skills, Dependencies.

Manage Skills

skild info <skill>       # Show details
skild update <skill>     # Update to latest
skild uninstall <skill>  # Remove
skild validate <path>    # Validate structure

Search Registry

skild search <query>

Browse online: hub.skild.sh

Target Platforms

# Example: Install to Antigravity
skild install @publisher/skill -t antigravity

# Project-level installation
skild install @publisher/skill --local

Skillsets

Skillsets bundle multiple Skills for one-command installation:

skild install @skild/data-analyst-pack
# Installs: csv, pandas, sql-helper...

Publishing Skills

# 1. Create account
skild signup

# 2. Login
skild login

# 3. Publish
skild publish --dir ./my-skill

Command Reference

For the complete command reference with all options, see commands.md.

Skillsets

For detailed Skillsets guide (bundles of Skills), see skillsets.md.

Troubleshooting

For common issues and solutions, see troubleshooting.md.

More Info

• Website: skild.sh
• Hub: hub.skild.sh
• Documentation: GitHub