{'>'}_
English 繁體中文 日本語 한국어 Deutsch Español Français
Login

Agent Skill: Guide for structuring Netresearch skill repositories. Use when creating skills, standardizing repos, or setting up composer/release workflows. By Netresearch.

0 stars
0 forks
Shell
4 views
View on GitHub Add to Favorites

SKILL.md

name: skill-repo description: "Agent Skill: Guide for structuring Netresearch skill repositories. Use when creating skills, standardizing repos, or setting up composer/release workflows. By Netresearch."

Skill Repository Structure Guide

Standards for Netresearch skill repository layout and distribution.

When to Use

  • Creating a new skill repository
  • Standardizing an existing skill repo
  • Setting up release workflows

Repository Structure

{skill-name}/
├── SKILL.md              # AI instructions (required)
├── README.md             # Human documentation (required)
├── LICENSE               # MIT (required)
├── composer.json         # PHP distribution
├── references/           # Extended docs
├── scripts/              # Automation
└── .github/workflows/release.yml

SKILL.md Requirements

---
name: skill-name          # lowercase, hyphens, max 64 chars
description: "Agent Skill: ... By Netresearch."
---
  • Under 500 lines, use references/ for extended content

Installation Methods

  1. Marketplace: /plugin marketplace add netresearch/claude-code-marketplace
  2. Release: Download and extract to ~/.claude/skills/{name}/
  3. Composer: composer require netresearch/agent-{name}

Composer Package

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

Validation

scripts/validate-skill.sh

References

  • references/installation-methods.md
  • references/composer-setup.md
  • templates/README.md.template

Contributing: https://github.com/netresearch/skill-repo-skill

README

Skill Repository Structure Guide

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

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

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