Skill Repository Structure Guide
A Claude Code skill for standardizing Netresearch skill repository layout, distribution channels, packaging, and validation.
What this skill solves
Netresearch maintains many agent skills; without a shared layout, packaging and CI drift across repositories. This skill defines one standard repo shape, reusable workflows, split licensing, and validation scripts so new and existing skills stay consistent and shippable via marketplace, Composer, npm, and releases.
It extends Anthropic-style single-file skills with repository-level conventions (not a replacement for Anthropic’s skill-creator — see comparison below).
Compatibility
This is an Agent Skill following the open standard originally developed by Anthropic and released for cross-platform use.
Supported platforms:
- Claude Code (Anthropic)
- Cursor
- GitHub Copilot
- Other skills-compatible AI agents
Skills are portable packages of procedural knowledge that work across any AI agent supporting the Agent Skills specification.
Use when
- Creating or bootstrapping a Netresearch-style skill repository
- Standardizing layout,
composer.json, .claude-plugin/plugin.json, or release workflows
- Wiring reusable CI from
netresearch/skill-repo-skill
- Fixing validation errors from
validate-skill.sh or marketplace packaging
- Migrating to split licensing (
LICENSE-MIT + LICENSE-CC-BY-SA-4.0)
Expected outputs
- 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
Context requirements
- 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, …)
Example prompts
"Scaffold a new Netresearch skill repository from the templates in skill-repo-skill."
"Why does validate-skill.sh fail on my SKILL.md frontmatter?"
"Add composer.json and plugin.json for our new skill repo matching netresearch conventions."
"Wire our repo to use netresearch/skill-repo-skill validate.yml on every PR."
"Migrate this repo from a single LICENSE file to LICENSE-MIT and LICENSE-CC-BY-SA-4.0."
Related skills
Installation
Marketplace (recommended)
Add the Netresearch marketplace once, then browse and install skills:
/plugin marketplace add netresearch/claude-code-marketplace
Install with any Agent Skills-compatible agent:
npx skills add https://github.com/netresearch/skill-repo-skill --skill skill-repo
Download release
Download the latest release and extract to your agent’s skills directory.
Git clone
git clone https://github.com/netresearch/skill-repo-skill.git
Composer (PHP projects)
composer require netresearch/skill-repo-skill
Requires netresearch/composer-agent-skill-plugin.
npm (Node projects)
npm install --save-dev \
@netresearch/agent-skill-coordinator \
github:netresearch/skill-repo-skill
Requires @netresearch/agent-skill-coordinator, which discovers the skill in node_modules and registers it in AGENTS.md via a postinstall hook. For pnpm, allowlist the coordinator’s postinstall:
{
"pnpm": {
"onlyBuiltDependencies": ["@netresearch/agent-skill-coordinator"]
}
}
Repository layout
Standard skill repository (concept)
The layout for a Netresearch skill repository (one or more skills per repo):
