Skip to main content

Declarative Skill Manifest

Define your skill collection as code — install, share, and reproduce setups from a single config file.

When does this matter?

Use the declarative manifest when you want reproducible skill setups across machines, team onboarding with a single command, or open-source project bootstrap.

What Is a Skill Manifest?​

The skills: section in config.yaml serves as a portable declaration of your skill collection. Instead of manually installing skills one by one, you list them in config and run skillshare install to bring everything up.

# ~/.config/skillshare/config.yaml (global)
# or .skillshare/config.yaml (project)
skills:
  - name: react-best-practices
    source: anthropics/skills/skills/react-best-practices
    group: frontend                          # installed into frontend/
  - name: _team-skills
    source: my-org/shared-skills
    tracked: true
    group: devops                            # installed into devops/
  - name: commit
    source: anthropics/skills/skills/commit  # no group → root level

How It Works​

Install from Manifest​

Running skillshare install with no arguments reads the manifest and installs all listed skills:

# Global mode — installs all skills from ~/.config/skillshare/config.yaml
skillshare install

# Project mode — installs from .skillshare/config.yaml
skillshare install -p

# Preview without installing
skillshare install --dry-run

Skills that already exist are skipped automatically.

Automatic Reconciliation​

The manifest stays in sync with your actual skill collection:

  • skillshare install <source> — adds the installed skill to skills: automatically
  • skillshare uninstall <name>... — removes the entry from skills: automatically

You never need to edit the manifest manually (though you can).

Skill Entry Fields​

Each entry in the skills: list has these fields:

FieldRequiredDescription
nameYesSkill name (directory name in source)
sourceYesInstall source (GitHub shorthand, HTTPS URL, SSH URL)
trackedNotrue for tracked repositories (preserves .git)
groupNoSubdirectory path (e.g. frontend or frontend/vue). Corresponds to --into during install.

Use Cases​

Personal Setup​

Maintain your personal skill collection across machines:

# On machine A — skills are already installed and tracked in config
skillshare push   # backup config to git

# On machine B — fresh machine
skillshare pull   # restore config from git
skillshare install  # install all skills from manifest
skillshare sync   # distribute to all targets

Team Onboarding​

New team members get the same AI context in one command:

# .skillshare/config.yaml is committed to the repo
git clone <project-repo>
cd <project-repo>
skillshare install -p   # installs all declared skills
skillshare sync -p      # links to project targets

Open-Source Bootstrap​

Project maintainers declare recommended skills:

# .skillshare/config.yaml
skills:
  - name: react-best-practices
    source: anthropics/skills/skills/react-best-practices
    group: frontend
  - name: commit
    source: anthropics/skills/skills/commit
  - name: project-conventions
    source: ./skills/project-conventions
Group field and --into

When you install with --into, the group is recorded automatically:

skillshare install anthropics/skills/skills/pdf --into frontend
# config.yaml will contain: name: pdf, group: frontend

Running skillshare install (no args) recreates the same directory structure from the manifest.

Contributors clone and run skillshare install -p to get project-specific AI context immediately.

Workflow Summary​

1. Install skills normally      →  manifest auto-updates
2. Push/pull config via git     →  portable across machines
3. Run `skillshare install`     →  reproduce on new machine
4. Run `skillshare sync`        →  distribute to all targets