peiiii/skild/skild-2

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).
• /discover supports pagination and filtering:
• cursor=<nextCursor> for pagination
• sort=updated|new|downloads_7d|downloads_30d|stars|stars_30d
• skillset=true|false and category=<id> to narrow results
• 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
 
# Aliases (npm-style)
skild add @publisher/skill-name
skild i @publisher/skill-name
 
# Pick one Skill when source has multiple SKILL.md
skild install owner/repo --skill skills/pdf

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
skild sync [skills...]   # Sync across platforms

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

Defaults & Scope

# Default platform & scope
skild config set defaultPlatform codex
skild config set defaultScope project
 
# Default repo for push
skild config set push.defaultRepo owner/repo

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

Push to Git Repos (Registry-free)

Use skild push to sync a Skill into a Git repository and push changes.

# Push to GitHub by owner/repo
skild push owner/repo --dir ./my-skill
 
# Set a default repo (omit <repo> afterwards)
skild config set push.defaultRepo owner/repo
skild push --dir ./my-skill
 
# Push to a local repo path
skild push ~/work/skills-repo --local --dir ./my-skill
 
# Push to a specific subdirectory
skild push owner/repo --dir ./my-skill --path skills/my-skill
 
# Push to a branch (or append #branch to the repo)
skild push owner/repo#dev --dir ./my-skill

Notes:

• The target path defaults to skills/<skill-name> derived from SKILL.md.
• Target path cannot be the repo root.
• The command clones, commits, and pushes to the remote branch.
• For owner/repo, skild tries SSH first and falls back to HTTPS if SSH auth fails.
• skild push <repo> always overrides the default repo.
• You can also set SKILD_DEFAULT_PUSH_REPO to override the default repo per shell.

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