Skip to content

Commit ef3169d

Browse files
committed
fix: change composer naming convention from agent-* to *-skill
Drop the netresearch/agent-{name} prefix convention. Composer package names now match the GitHub repo name: netresearch/{name}-skill. Updated: validation script, SKILL.md, templates, references. Signed-off-by: Sebastian Mendel <sebastian.mendel@netresearch.de> Signed-off-by: Sebastian Mendel <info@sebastianmendel.de>
1 parent 04af394 commit ef3169d

File tree

7 files changed

+21
-22
lines changed

7 files changed

+21
-22
lines changed

composer.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
2-
"name": "netresearch/agent-skill-repo",
2+
"name": "netresearch/skill-repo-skill",
33
"description": "Guide for structuring Netresearch skill repositories with multi-channel distribution",
44
"type": "ai-agent-skill",
55
"license": "MIT",

skills/skill-repo/SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -41,13 +41,13 @@ description: "Use when <trigger conditions>"
4141

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

4646
## Composer Package
4747

4848
```json
4949
{
50-
"name": "netresearch/agent-{skill-name}",
50+
"name": "netresearch/{skill-name}",
5151
"type": "ai-agent-skill",
5252
"require": {"netresearch/composer-agent-skill-plugin": "*"},
5353
"extra": {"ai-agent-skill": "SKILL.md"}

skills/skill-repo/references/composer-setup.md

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -8,18 +8,18 @@ Add `composer.json` to ALL skills **EXCEPT** those explicitly targeting non-PHP
88

99
| Skill Type | composer.json |
1010
|------------|---------------|
11-
| PHP/TYPO3 skills | Required |
12-
| General skills | Required |
13-
| Go-specific skills | Not needed |
14-
| Rust-specific skills | Not needed |
11+
| PHP/TYPO3 skills | Required |
12+
| General skills | Required |
13+
| Go-specific skills | Not needed |
14+
| Rust-specific skills | Not needed |
1515

1616
## composer.json Structure
1717

1818
### Basic Structure
1919

2020
```json
2121
{
22-
"name": "netresearch/agent-{skill-name}",
22+
"name": "netresearch/{skill-name}-skill",
2323
"description": "{Skill description from SKILL.md}",
2424
"type": "ai-agent-skill",
2525
"license": "MIT",
@@ -44,26 +44,25 @@ Add `composer.json` to ALL skills **EXCEPT** those explicitly targeting non-PHP
4444

4545
| Field | Value | Purpose |
4646
|-------|-------|---------|
47-
| `name` | `netresearch/agent-{skill-name}` | Package identifier |
47+
| `name` | `netresearch/{name}-skill` | Package identifier (matches repo name) |
4848
| `type` | `ai-agent-skill` | Enables plugin discovery |
4949
| `require` | `composer-agent-skill-plugin` | Plugin dependency |
5050
| `extra.ai-agent-skill` | Path to SKILL.md | Skill location |
5151

5252
### Package Naming Convention
5353

54-
- Prefix: `netresearch/agent-`
55-
- Suffix: skill name without `-skill` suffix
54+
- Pattern: `netresearch/{name}-skill` (matches the GitHub repo name)
5655
- Examples:
57-
- `typo3-docs-skill``netresearch/agent-typo3-docs`
58-
- `enterprise-readiness-skill``netresearch/agent-enterprise-readiness`
56+
- `typo3-docs-skill``netresearch/typo3-docs-skill`
57+
- `enterprise-readiness-skill``netresearch/enterprise-readiness-skill`
5958

6059
## Multi-Skill Packages
6160

6261
For packages containing multiple skills:
6362

6463
```json
6564
{
66-
"name": "netresearch/agent-{package-name}",
65+
"name": "netresearch/{name}-skill",
6766
"type": "ai-agent-skill",
6867
"extra": {
6968
"ai-agent-skill": [
@@ -78,7 +77,7 @@ For packages containing multiple skills:
7877

7978
```json
8079
{
81-
"name": "netresearch/agent-jira-skill",
80+
"name": "netresearch/jira-skill",
8281
"extra": {
8382
"ai-agent-skill": [
8483
"skills/jira-communication/SKILL.md",

skills/skill-repo/references/installation-methods.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -74,7 +74,7 @@ For PHP projects, install skills as Composer packages.
7474
composer require netresearch/composer-agent-skill-plugin
7575

7676
# Install skills
77-
composer require netresearch/agent-{skill-name}
77+
composer require netresearch/{skill-name}-skill
7878
```
7979

8080
### How It Works
@@ -106,4 +106,4 @@ composer require netresearch/agent-{skill-name}
106106
|--------|----------|
107107
| Marketplace | Managed by Claude Code |
108108
| Release | `~/.claude/skills/{skill-name}/` |
109-
| Composer | `vendor/netresearch/agent-{skill-name}/` |
109+
| Composer | `vendor/netresearch/{skill-name}-skill/` |

skills/skill-repo/scripts/validate-skill.sh

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -130,12 +130,12 @@ if [[ -f "$REPO_DIR/composer.json" ]]; then
130130
error "composer.json type must be 'ai-agent-skill'"
131131
fi
132132

133-
# Name pattern
133+
# Name pattern: netresearch/*-skill or netresearch/*-agent-skill
134134
COMP_NAME=$(python3 -c "import json; print(json.load(open('$REPO_DIR/composer.json')).get('name',''))" 2>/dev/null || echo "")
135-
if [[ "$COMP_NAME" == netresearch/agent-* ]]; then
135+
if [[ "$COMP_NAME" =~ ^netresearch/.*-skill$ ]]; then
136136
success "composer.json name: $COMP_NAME"
137137
else
138-
error "composer.json name must match netresearch/agent-*: $COMP_NAME"
138+
error "composer.json name must match netresearch/*-skill or netresearch/*-agent-skill: $COMP_NAME"
139139
fi
140140

141141
# Plugin dependency

skills/skill-repo/templates/README.md.template

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ Download the [latest release](https://github.com/netresearch/{skill-repo}/releas
2525
### Option 3: Composer (PHP projects)
2626

2727
```bash
28-
composer require netresearch/agent-{skill-name}
28+
composer require netresearch/{skill-name}-skill
2929
```
3030

3131
**Requires:** [netresearch/composer-agent-skill-plugin](https://github.com/netresearch/composer-agent-skill-plugin)

skills/skill-repo/templates/composer.json.template

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
2-
"name": "netresearch/agent-{skill-name}",
2+
"name": "netresearch/{skill-name}-skill",
33
"description": "{Skill description}",
44
"type": "ai-agent-skill",
55
"license": "MIT",

0 commit comments

Comments
 (0)