Development

Skill Repository

Guide for structuring Netresearch skill repositories with multi-channel distribution. Covers repository standards, composer.json configuration, release workflows, and validation scripts.

Latest release v1.20.0

Install

Pick whichever fits your project — they all reach the same skill.

  1. Claude Code via this marketplace
    /plugin install skill-repo@netresearch-claude-code-marketplace
  2. npx any Agent Skills CLI
    npx skills add https://github.com/netresearch/skill-repo-skill --skill skill-repo

    Universal Agent Skills CLI from skills.sh — works across Claude Code, Cursor, GitHub Copilot, Codex, Gemini CLI and 30+ more agents.

  3. composer require PHP project, as a package
    composer require netresearch/skill-repo-skill

    Requires netresearch/composer-agent-skill-plugin — resolves Agent Skills as Composer dependencies in PHP projects, auto-discovers skills, generates AGENTS.md.

  4. composer skills:add PHP project, direct source
    composer skills:add github:netresearch/skill-repo-skill

    Provided by netresearch/composer-agent-skill-plugin — pins skill repos directly without going through Packagist, locks them in composer.skills.lock.

What you can do with it

  • Guide for structuring Netresearch skill repositories with multi-channel distribution
  • Covers repository standards, composer.json configuration, release workflows, and validation scripts

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: bash 4.3+ and python3 on PATH when running validate-skill.sh (JSON checks use Python, not jq)
  • 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, …)

Tags

  • development
  • meta