netresearch/agent-skill-repo

Guide for structuring Netresearch skill repositories with multi-channel distribution

v1.0.1 2025-12-16 11:45 UTC

Requires

• netresearch/composer-agent-skill-plugin: *

MIT

• Netresearch DTT GmbH

README

A Claude Code skill for standardizing Netresearch skill repository layout, distribution channels, and packaging.

Features

• Repository Structure Standards - Consistent layout across all Netresearch skills
• Multi-Channel Distribution - Marketplace, GitHub releases, Composer
• README.md Template - Standardized human documentation
• Composer Integration - PHP ecosystem distribution via composer-agent-skill-plugin
• Release Workflow - Automated packaging excluding dev files
• Validation Script - Verify skill repo compliance

Installation

Option 1: Via Netresearch Marketplace (Recommended)

/plugin marketplace add netresearch/claude-code-marketplace

Then browse skills with /plugin.

Option 2: Download Release

Download the latest release and extract to ~/.claude/skills/skill-repo/

Option 3: Composer (PHP projects)

composer require netresearch/agent-skill-repo

Requires: netresearch/composer-agent-skill-plugin

Usage

The skill triggers on keywords like:

• "create skill"
• "skill repository"
• "skill structure"
• "standardize skill"
• "composer.json for skill"
• "release workflow"

Example Prompts

"Help me create a new skill repository"
"Standardize this skill repo structure"
"Add composer.json to this skill"
"Set up release workflow for this skill"
"Validate this skill repository"

What This Skill Provides

Repository Layout

{skill-name}/
├── SKILL.md              # AI instructions
├── README.md             # Human documentation
├── LICENSE               # MIT license
├── composer.json         # PHP distribution
├── references/           # Extended docs
├── scripts/              # Automation
├── assets/               # Templates
└── .github/workflows/    # CI/CD

Three Installation Methods

1. Marketplace - /plugin marketplace add netresearch/claude-code-marketplace
2. Release Download - GitHub Releases (skill files only)
3. Composer - composer require netresearch/agent-{skill-name}

Composer Package Requirements

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

Structure

skill-repo-skill/
├── SKILL.md                      # AI instructions
├── README.md                     # This file
├── LICENSE                       # MIT
├── composer.json                 # PHP distribution
├── templates/
│   ├── README.md.template        # README template for skills
│   ├── composer.json.template    # Composer template
│   └── release.yml.template      # Release workflow template
├── references/
│   ├── installation-methods.md   # Detailed install guides
│   ├── composer-setup.md         # Composer integration
│   └── marketplace-integration.md
└── scripts/
    └── validate-skill.sh         # Validation script

Extends Anthropic's Skill Creator

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

Aspect	Anthropic's skill-creator	This skill adds
Focus	SKILL.md content	Repository structure
Scope	Single file	Full repo layout
Distribution	Claude Code native	+ Marketplace, Composer
Audience	AI instructions	+ Human README

Contributing

Contributions welcome! Please submit PRs for:

• Template improvements
• Additional validation checks
• Documentation updates

License

MIT License - See LICENSE for details.

Credits

Developed and maintained by Netresearch DTT GmbH.

Made with ❤️ for Open Source by Netresearch