Skill Repository
Guide for structuring Netresearch skill repositories with multi-channel distribution. Covers repository standards, composer.json configuration, release workflows, and validation scripts.
Install
Choose a supported route below. Package contents, agent registration and runtime dependencies can differ between installers.
-
Claude Code via this marketplace /plugin install skill-repo@netresearch-claude-code-marketplaceFirst add the marketplace once in Claude Code:
/plugin marketplace add netresearch/claude-code-marketplace. Then install the selected plugin. For setup and installation scopes, seeClaude Code plugin setupA plugin can include several skills and additional components. -
npx interactive skill selection npx skills add https://github.com/netresearch/skill-repo-skillRequires Node.js 22.20+. Run from the target project, then choose the source skills and agents in the installer. Uses the skills CLI from
skills.shInstalls skill instructions. Extra plugin hooks, commands and external runtime tools are not installed by this route. -
composer require PHP project, as a package composer require netresearch/skill-repo-skillAllow the Composer skill installer to activate and approve skill registration when prompted. Requires
netresearch/composer-agent-skill-pluginDiscovers trusted skill packages and registers their instructions in AGENTS.md. Runtime tools may need separate setup. -
composer skills:add PHP project, direct source composer skills:add netresearch/skill-repo-skillInstall and activate netresearch/composer-agent-skill-plugin first; approve the selected source's skill registration. Provided by
netresearch/composer-agent-skill-pluginPins source repositories without a Packagist package and records them incomposer.skills.lock. Runtime dependencies remain separate.
What you can do with it
- Creating or bootstrapping a Netresearch-style skill repository
- Standardizing layout,
composer.json,plugin.json/.claude-plugin/plugin.json, or release workflows - Wiring reusable CI from
netresearch/skill-repo-skill - Fixing validation errors from
validate-skill.shor marketplace packaging - Migrating to split licensing (
LICENSE-MIT+LICENSE-CC-BY-SA-4.0)
What you get back
- A documented directory layout and templates for new repos
- Validation: structural checks for
SKILL.md, licenses,composer.json,plugin.json - Release discipline: tag-driven packaging aligned with plugin version
- References for installation paths, marketplace sync, and release safety
What it expects in your project
- Validation script:
bash4.3+ andpython3(3.11+) on PATH when runningvalidate-skill.sh(JSON checks use Python, notjq) - Target repos: GitHub-hosted Netresearch skill repos using split licensing and Composer type
ai-agent-skill - CI: consuming repos call reusable workflows from this repository (
validate.yml,release.yml, …)