Agent skill

Skild

by Peiiii in Peiiii/skild

Skill package manager for AI Agents — install, manage, and publish Agent Skills.

MITAuto-check passed

Install Skild

skills CLI
$ npx skills add Peiiii/skild --skill skild -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Peiiii/skild skild --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Peiiii/skild.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/skild .claude/skills/skild && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
skild
GitHub stars
115
Token cost
~1.4k tokens
SKILL.md length
375 words
Files
4
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Skill package manager for AI Agents — install, manage, and publish Agent Skills.

  • Works in 4 steps: Search via /discover and shortlist… → Confirm with the user and pick the best… → Install using the provided install… → …
  • SKILL.md covers When to Use, Agent Search & Discovery…, Agent Workflow (Recommended) and Prerequisites, plus 10 more sections
  • Calls curl and npm; reaches registry.skild.sh

What it does

Skild is an agent skill from Peiiii/skild. Skill package manager for AI Agents — install, manage, and publish Agent Skills.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `commands.md`, `skillsets.md` and `troubleshooting.md`).

The repository describes itself as: The npm for Agent Skills — Discover, install, manage, and publish AI Agent Skills with ease. The licence is MIT.

Example prompts

  • “/skild”

Requirements

  • Node.js

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  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.

What it can do on your machine

Read from SKILL.md and the folder at commit 42d6316. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • registry.skild.sh

    Also links to:

    • hub.skild.sh
    • skild.sh

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Skild loads about 1.4k tokens when it runs. Until then it costs about 22 tokens; SKILL.md has 375 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~22
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Peiiii/skild at commit 42d6316, republished under its MIT licence (© Peiiii). 375 words, ~1,385 tokens.

Download SKILL.mdSave it as .claude/skills/skild/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
skild
description
Skill package manager for AI Agents — install, manage, and publish Agent Skills.
version
0.2.10
author
Peiiii
license
MIT
tags
cli, package-manager, skills

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:

bash
# 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.
  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.

bash
npm install -g skild

Core Commands

Install a Skill
bash
# 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
bash
skild list

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

Manage Skills
bash
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
bash
skild search <query>

Browse online: hub.skild.sh

Target Platforms

PlatformOptionGlobal PathProject Path
Claude-t claude (default)~/.claude/skills./.claude/skills
Codex-t codex~/.codex/skills./.codex/skills
Copilot-t copilot~/.github/skills./.github/skills
Antigravity-t antigravity~/.gemini/antigravity/skills./.agent/skills
OpenCode-t opencode~/.config/opencode/skill./.opencode/skill
Cursor-t cursor~/.cursor/skills./.cursor/skills
Windsurf-t windsurf~/.windsurf/skills./.windsurf/skills
Agents-t agents~/.agents/skills./.agents/skills
bash
# Example: Install to Antigravity
skild install @publisher/skill -t antigravity

# Project-level installation
skild install @publisher/skill --local
Show full SKILL.md (131 more words)Show less

Defaults & Scope

bash
# 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:

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

Publishing Skills

bash
# 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.

bash
# 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

© Peiiii, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files in skills/skild of Peiiii/skild.

  • SKILL.md
  • commands.md
  • skillsets.md
  • troubleshooting.md

Open the folder on GitHubat commit 42d6316

Compare with similar skills

Skild next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Skild compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skild this skillPeiiii/skild115—~1.4kAutomated safety check: PassMIT
Publishcode-yeongyu/oh-my-openagent70k—~5.5kAutomated safety check: WarnCustom licence
Social Publisheraffaan-m/ECC276k1 repos~1.1kAutomated safety check: PassMIT
Publishyc-software/qm15k—~2.2kAutomated safety check: WarnMIT
Social Publishingwshobson/agents40k—~914Automated safety check: PassMIT
PublishQ00/ouroboros6.2k—~2.7kAutomated safety check: PassMIT

Similar skills

  • Publish

    code-yeongyu/oh-my-openagent

    Publish oh-my-opencode to npm by triggering the GitHub Actions publish workflow and verifying its artifacts.

    70k GitHub stars~5.5k tokensUpdated today
    DevOps & CloudAuto-check: warnings
  • Social Publisher

    affaan-m/ECC

    Agent-driven scheduling and publishing of social media posts across 13 platforms via SocialClaw.

    276k GitHub starsUsed in 1 repo~1.1k tokens
    Writing & ContentAuto-check passed
  • Publish

    yc-software/qm

    Publish a long-lived internal web app, site, or dashboard from the agent computer.

    15k GitHub stars~2.2k tokensUpdated today
    DevOps & CloudAuto-check: warnings
  • Social Publishing

    wshobson/agents

    Schedule and publish social media posts across 13 platforms (X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, Pinterest) via the SocialClaw API.

    40k GitHub stars~914 tokensUpdated 4 days ago
    Writing & ContentAuto-check passed
  • Publish

    Q00/ouroboros

    Publish Seed specification as GitHub Issues for team-based project management

    6.2k GitHub stars~2.7k tokensUpdated 2 days ago
    Product & Project ManagementAuto-check passed
  • Shipvela Publish

    sickn33/agentic-awesome-skills

    Publish an explicitly selected website through the user's connected Shipvela MCP account, track the exact deployment, and return its live HTTPS URL after success.

    47k GitHub stars~1.9k tokensUpdated today
    DevOps & CloudAuto-check: notes

Questions about Skild

What does Skild do?

Skill package manager for AI Agents — install, manage, and publish Agent Skills. Skild is an agent skill from Peiiii/skild. Skill package manager for AI Agents — install, manage, and publish Agent Skills.

How do I install Skild in Claude Code?

Run `npx skills add Peiiii/skild --skill skild -a claude-code`. Or copy the skill folder (skills/skild in Peiiii/skild) into .claude/skills/skild in your project. Claude Code loads it when a task matches its description.

How do I install Skild in Codex?

Run `npx skills add Peiiii/skild --skill skild -a codex`. Or copy the skill folder (skills/skild in Peiiii/skild) into .agents/skills/skild in your project. Codex loads it when a task matches its description.

Can I use Skild in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Peiiii/skild --skill skild -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skild, .gemini/skills/skild, .github/skills/skild and .opencode/skills/skild in your project.

What does Skild need to run?

Going by SKILL.md and its folder, Skild needs the command-line tools its instructions call (curl and npm). Our summary lists: Node.js.

Does Skild access the network?

SKILL.md names 3 domains. In commands or code: registry.skild.sh; the agent is likely to contact it when it follows the instructions. As links in the text: hub.skild.sh and skild.sh. This is read from the text; nothing was executed.

Is Skild safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Skild use?

Skild is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Skild use?

About 1.4k tokens (SKILL.md is roughly 5.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Skild?

Skills that share tags, products or a category with Skild: Publish (code-yeongyu/oh-my-openagent, 70k stars), Social Publisher (affaan-m/ECC, 276k stars), Publish (yc-software/qm, 15k stars) and Social Publishing (wshobson/agents, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Skild?

Peiiii (a GitHub user) maintains it in Peiiii/skild, which has 115 GitHub stars. The repository was last updated on September 18, 2026.

Source: Peiiii/skild on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.