skillhost 0.1.0

Install Agent Skills from Git repositories using symlinks

Skillhost

Install Agent Skills from Git repos into Codex, Claude Code, and OpenCode using symlinks.

Skillhost is intentionally small:

• Git is the distribution system.
• Symlinks are the install system.
• No registry, no server, no account.
• Manifest files make unlink and remove safe.

The tool website is skillhost.dev.

Install

pipx install skillhost
uv tool install skillhost

From a checkout you can also run:

pipx install .
uv tool install .
pip install .

User-level skills

User-level skills are shared across projects.

skillhost add [e-mail]:your-org/company-skills.git
skillhost update
skillhost link
skillhost list
skillhost doctor

By default skillhost link links to all supported agents. You can target one agent:

skillhost link --agent codex
skillhost unlink --agent claude --dry-run

Project-level skills

Project-level skills are linked into the current Git repository checkout. There is no full-disk search and no automatic discovery across all checkouts.

cd ~/code/my-project
skillhost project register my-project --git [e-mail]:your-org/my-project.git
skillhost project add [e-mail]:your-org/my-project-skills.git --project my-project
skillhost project link

skillhost project link determines the current Git repository root with Git, reads the origin remote, normalizes it, and matches it against registered project remotes. If it cannot match the current directory, register the project first.

Target directories

User targets:

• Codex: ~/.agents/skills
• Claude Code: ~/.claude/skills
• OpenCode: ~/.config/opencode/skills

Project targets:

• Codex: .agents/skills
• Claude Code: .claude/skills
• OpenCode: .opencode/skills

Skillhost uses each agent's native target directory. It does not rely on one agent reading another agent's directory.

Source repository layouts

Single skill repo:

my-skill/
  SKILL.md

Skill collection repo:

company-skills/
  skills/
    git/
      SKILL.md
    db/
      SKILL.md

Flat collection repo:

company-skills/
  git/
    SKILL.md
  db/
    SKILL.md

Skill discovery is shallow and only considers valid skills that contain SKILL.md. It does not recursively scan references, assets, examples, scripts, docs, or tests.

Frontmatter

A SKILL.md can include simple YAML-style frontmatter:

---
name: ng-git
description: Narrative git workflow helpers
---

Skill names must contain only lowercase letters, digits, and hyphens. If no name is present, Skillhost uses the skill directory or repo name.

Conflict policy

• Existing user-owned skills are never overwritten.
• Duplicate skill names across source repos are skipped and reported.
• unlink only removes skillhost-managed symlinks recorded in .skillhost-links.json.
• remove unlinks manifest-managed symlinks before deleting a user repo; dirty repos are refused unless --force is used.

Security

Skillhost never executes code from skill repositories. It only:

1. clones repositories with Git,
2. updates repositories with git pull --ff-only,
3. reads SKILL.md metadata, and
4. creates or removes manifest-managed symlinks.

Skillhost does not implement registry support, semver, package resolution, full-disk project discovery, or auto-running skill scripts.