skill-repo

# 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](https://agentskills.io) 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)

```bash
/plugin marketplace add netresearch/claude-code-marketplace
```

Then browse skills with `/plugin`.

### Option 2: Download Release

Download the [latest release](https://github.com/netresearch/skill-repo-skill/releases/latest) and extract to `~/.claude/skills/skill-repo/`

### Option 3: Composer (PHP projects)

```bash
composer require netresearch/agent-skill-repo
```

**Requires:** [netresearch/composer-agent-skill-plugin](https://github.com/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](LICENSE) for details.

## Credits

Developed and maintained by [Netresearch DTT GmbH](https://www.netresearch.de/).

---

**Made with ❤️ for Open Source by [Netresearch](https://www.netresearch.de/)**