skill-repo

Category: Tools & Productivity | Uploader: netresearch | Downloads: 0 | Version: v1.0（Latest）

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

Changelog: Source: GitHub https://github.com/netresearch/skill-repo-skill

Directory Structure

Current level: skills/skill-repo/

📁 references/
- 📄 composer-setup.md 3.7 KB
- 📄 installation-methods.md 2.2 KB
- 📄 marketplace-integration.md 4.5 KB
📁 scripts/
- 📄 migrate-licensing.sh 5.7 KB
- 📄 validate-skill.sh 10.8 KB
📁 templates/
- 📄 composer.json.template 417 B
- 📄 LICENSE-CC-BY-SA-4.0.template 839 B
- 📄 LICENSE-MIT.template 1.1 KB
- 📄 pre-commit.template 434 B
- 📄 README.md.template 2.0 KB
- 📄 release.yml.template 1.8 KB
📄 SKILL.md 2.2 KB

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

```yaml
---
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.

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

## Validation

```bash
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

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

skill-repo

Directory Structure

SKILL.md

Report

Notice