Download the PHP package netresearch/agent-skill-repo without Composer

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).

Why this is a skill (model delta)

• Value categories: org/project-specific knowledge (Netresearch repo shape, split licensing, composer type ai-agent-skill) and executable scripts/validators (validate-skill.sh, checkpoints.yaml).
• Without the skill: the model invents a plausible generic repo layout — single LICENSE, no plugin.json, composer.json without the ai-agent-skill type — that fails validate-skill.sh and org CI.
• Eval evidence: validate_skill_repo_structure and readme_requirements in skills/skill-repo/evals/evals.json.

Compatibility

This is an Agent Skill following the open standard originally developed by Anthropic and released for cross-platform use. The repository is also packaged as an Agent Plugins 1.0.0 plugin: the root plugin.json plus skills/ layout is what any conformant client loads.

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, plugin.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

Related skills

• agent-rules-skill — AGENTS.md and agent onboarding patterns
• agent-harness-skill — harness verification and docs layout

Installation

Marketplace (recommended)

Add the Netresearch marketplace once, then install this plugin from it:

Do not run /plugin marketplace add netresearch/skill-repo-skill. marketplace add needs a .claude-plugin/marketplace.json catalog; this repo ships a .claude-plugin/plugin.json plugin manifest, so that fails with Marketplace file not found.

Without a marketplace: skills directory (Claude Code 2.1.157+)

Loads as skill-repo@skills-dir on the next session. Update with git -C ~/.claude/skills/skill-repo pull and start a new session; remove by deleting the directory.

npx (skills.sh)

Install with any Agent Skills-compatible agent:

Limitation: npx skills installs SKILL.md-based skills only. It reads .claude-plugin/plugin.json to locate skills, not to register a plugin, so hooks/, agents/, commands/, bin/ and .mcp.json are left out. Use the marketplace or the skills directory when a repo ships any of those.

Download release

Download the latest release and extract to your agent’s skills directory.

Composer (PHP projects)

Requires netresearch/composer-agent-skill-plugin.

npm (Node projects)

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:

Repository layout

Standard skill repository (concept)

The layout for a Netresearch skill repository (one or more skills per repo):

Installation methods (summary)

1. Marketplace (recommended) — /plugin marketplace add netresearch/claude-code-marketplace, then /plugin install <plugin-name>@netresearch-claude-code-marketplace
2. Skills directory — clone into ~/.claude/skills/<plugin-name>/; loads as <plugin-name>@skills-dir, no marketplace (Claude Code 2.1.157+)
3. npx (skills.sh) — npx skills add <repo-url> --skill <name> (skills only: drops hooks, agents, commands, bin/)
4. Release download — GitHub Releases (skill files only)
5. Composer — composer require netresearch/<repo-name> (PHP projects)
6. npm — coordinator + github:<org>/<repo> (Node projects)

Composer package requirements

• "type": "ai-agent-skill"
• "require": {"netresearch/composer-agent-skill-plugin": "*"}
• "extra": {"ai-agent-skill": "skills/{skill-name}/SKILL.md"}

This repository (skill-repo-skill)

This repo dogfoods the layout and hosts reusable CI workflows for other Netresearch skill repos:

See docs/ARCHITECTURE.md for component responsibilities.

Extends Anthropic's Skill Creator

This skill extends (not replaces) Anthropic’s skill-creator:

Contributing

Contributions welcome. Please open PRs for:

• Template improvements
• Additional validation checks
• Documentation updates

License

This project uses split licensing:

• Code (scripts, workflows, configs): MIT
• Content (skill definitions, documentation, references): CC-BY-SA-4.0

See the individual license files for full terms.

Credits

Developed and maintained by Netresearch DTT GmbH.

Made with ❤️ for Open Source by Netresearch