Claude Code Plugins

Community-maintained marketplace

Feedback

skill-repo

@netresearch/skill-repo-skill
1
0

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

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name skill-repo
description Use when creating new skill repositories, standardizing existing skill repos, or setting up composer/release workflows for skills.

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           # Code license (required)
├── LICENSE-CC-BY-SA-4.0  # Content license (required)
├── composer.json         # PHP distribution
├── references/           # Extended docs
├── scripts/              # Automation
└── .github/workflows/release.yml

Licensing

Skill repos use split licensing:

Path pattern License
skills/**/*.md, references/**, assets/**/*.md, README.md, docs/** CC-BY-SA-4.0
scripts/**, Build/**, .github/workflows/**, *.sh, *.py, *.php MIT
composer.json, plugin.json, config files MIT
Code snippets embedded in .md files Dual (both apply)

Composer/plugin metadata uses SPDX compound expression: (MIT AND CC-BY-SA-4.0)

SKILL.md Requirements

---
name: skill-name          # lowercase, hyphens, max 64 chars
description: "Use when <trigger conditions>"
---
  • 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/{repo-name}

Composer Package

Composer name must match GitHub repo name exactly.

{
  "name": "netresearch/{repo-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