Adopted

skills-house Distribution Model

Jul 2026 · 6 min read

Status: Adopted (Jul 2026)
Author: al4f
Repo: skills-house
Spec: specs/architecture/distribution.md

Summary

skills-house is a framework for authors, not a skill catalog. Distribution uses two channels:

  1. Primary — skills.sh: npx skills add al4f/skills-house --skill <name>
  2. Secondary — npm: built dist packages @skills-house/skill-<name> via git tags

Primary: skills.sh

Uses the official skills.sh CLI. Clones the public GitHub repo; no custom skills-house npm CLI required.

npx skills add al4f/skills-house --list
npx skills add al4f/skills-house --skill skill-auditor -a cursor -y

Secondary: npm dist

Per-skill packages contain built skills-dist/<name>/ only. Published by GitHub Actions on tags like v0.0.1-skill-auditor.

@skills-house/skill-skill-auditor

Framework npm packages

Authors who scaffold outside the monorepo get three published tools under @skills-house:

  • @skills-house/build — skill compiler
  • @skills-house/install — install built dist into agent directories (dev/dogfooding)
  • @skills-house/create — project scaffold that vendors build + install

Published via git tags (v*-build, v*-install, v*-create). See NPM-SETUP.md.

Non-goals

  • Skills marketplace UI
  • Private registry support
  • Skill catalog in this repo (one example only)
  • Custom @skills-house/install as consumer install path

Metrics philosophy

npm downloads and skills.sh install telemetry are useful signals — not success metrics. Reputation comes from educational content and DX.

Feedback

Open a GitHub issue with tag distribution-rfc.