Skip to content

Peiiii/skild

Repository files navigation

🛡️ skild

Get your agents skilled.

The npm for Agent Skills — Discover, install, manage, and publish AI Agent Skills with ease

npm version License: MIT

Website · Documentation · Skild Hub

English | 简体中文


🚀 Quick Start

npm i -g skild
skild install anthropics/skills
skild list
skild update
skild push owner/repo --dir ./my-skill

That's it. Your agent is ready to install and manage skills.

🧭 Command Overview

Command Description
skild install <source> Install a Skill (Git URL / local / registry)
skild list List installed Skills
skild info <skill> Show Skill details
skild update [skill] Update installed Skills
skild sync [skills...] Auto-detect missing installs and sync
skild uninstall <skill> Remove a Skill
skild init <name> Create a new Skill project
skild validate [path|skill] Validate a Skill folder or installed Skill
skild push <repo> Push a Skill to a Git repository
skild extract-github-skills <source> Extract GitHub Skills into a local catalog
skild search <query> Search the registry
skild signup Create a publisher account
skild login Login to registry
skild whoami Show current identity
skild logout Remove credentials
skild publish Publish a Skill to the registry

Run skild <command> --help for full options.

📖 What is this?

Agent Skills is an open standard by Anthropic for extending AI agents. skild is the package manager for these Skills — like npm, but for AI agents.

📦 Install Skills

# From GitHub (degit shorthand)
skild install anthropics/skills/skills/pdf

# From full GitHub URL
skild install https://github.com/anthropics/skills/tree/main/skills/pdf

# From local directory
skild install ./my-skill

# From registry
skild install @publisher/skill-name

# Force reinstall
skild install anthropics/skills/skills/pdf --force

🎁 Skillsets: One Pack, Many Skills

Skillsets bundle multiple skills together — install a complete toolkit with one command:

# Install a data analyst toolkit (includes csv, pandas, sql-helper...)
skild install @skild/data-analyst-pack

# All bundled skills are automatically installed
skild list

See Skillsets Guide for more.

🎯 Multi-platform Support

Default: Claude (~/.claude/skills). Also supports Codex, Copilot, Antigravity, OpenCode, Cursor, Windsurf:

# Install to Codex (global)
skild install anthropics/skills/skills/pdf -t codex

# Install to OpenCode (global)
skild install anthropics/skills/skills/pdf -t opencode

# Install to Cursor (global)
skild install anthropics/skills/skills/pdf -t cursor

# Install to Windsurf (global)
skild install anthropics/skills/skills/pdf -t windsurf

# Install to Codex (project-level)
skild install anthropics/skills/skills/pdf -t codex --local

# Install to Antigravity (project-level, ./.agent/skills)
skild install anthropics/skills/skills/pdf -t antigravity --local

# Install to OpenCode (project-level, ./.opencode/skill)
skild install anthropics/skills/skills/pdf -t opencode --local

# Install to Cursor (project-level, ./.cursor/skills)
skild install anthropics/skills/skills/pdf -t cursor --local

# Install to Windsurf (project-level, ./.windsurf/skills)
skild install anthropics/skills/skills/pdf -t windsurf --local

🔧 Manage Skills

skild list                 # List installed Skills
skild info pdf             # Show Skill details
skild validate pdf         # Validate Skill structure
skild update pdf           # Update a Skill
skild uninstall pdf        # Remove a Skill
skild push owner/repo --dir ./my-skill  # Push a Skill to a Git repo
skild sync                 # Auto-detect and sync missing installs across platforms (tree prompt)

🔄 Cross-platform Sync

Keep multiple tools in lockstep:

# Detect missing installs and choose with a tree (All → Platform → Skill)
skild sync

# Limit to certain skills / platforms
skild sync pdf web-scraper --to codex,cursor

# Non-interactive, overwrite existing
skild sync --yes --force

✨ Create Skills

skild init my-skill        # Create a new Skill project
cd my-skill
skild validate .           # Validate structure

Ready to share? See Publishing Skills for the complete guide.

📚 Documentation

⭐ Star History

Star History Chart

🤝 Contributing

Contributions welcome! See CONTRIBUTING.md for development setup and guidelines.

📄 License

MIT © Peiiii


🛡️ skild.sh

Get your agents skilled.

About

The npm for Agent Skills — Discover, install, manage, and publish AI Agent Skills with ease

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors