Skip to content

Commit 31a8b7f

Browse files
committed
Documentation
1 parent f0723d4 commit 31a8b7f

2 files changed

Lines changed: 3 additions & 26 deletions

File tree

CONTRIBUTING.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,6 @@ Best for cross-cutting skills that do not have a natural product home.
2323
```bash
2424
./.github/scripts/publish.sh # writes .cursor-plugin/marketplace.json
2525
```
26-
The bundle ships the skill folders in place (the plugin `source` is the repo root), so there is no generated plugin tree to commit — just your skill folder and the manifest edits.
2726
7. Validate the skill locally before pushing:
2827
```bash
2928
./.github/scripts/check.sh # validates every SKILL.md and that manifests are in sync
@@ -265,5 +264,4 @@ The validator checks every skill under `skills/` for:
265264
It also checks the plugin manifests:
266265

267266
- `.claude-plugin/marketplace.json` lists exactly one plugin (the `amd-skills` bundle) with `source` set to `./`, `strict: false`, and a non-empty human-readable `description`
268-
- every entry in that plugin's `skills` array is a `./skills/<name>` path that resolves to a real skill under `skills/`. Skills absent from the array are allowed — they are simply unpublished.
269267
- `.cursor-plugin/marketplace.json` is up to date — it mirrors `.claude-plugin/marketplace.json` and pulls shared identity (name, description, version, author) from `plugin-metadata.json` (regenerate with `./.github/scripts/publish.sh`)

README.md

Lines changed: 3 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -145,37 +145,16 @@ The AMD stack is large and moves fast. ROCm, HIP, Ryzen AI, and framework integr
145145
This repo also acts as an **incubator**: a skill can start under `skills/` to iterate quickly, then graduate to its product repo and be re-pointed from `.github/scripts/sources.yml` once it has a clear owner, with no change for installed users.
146146

147147
```
148-
skills/ # Canonical catalog: every skill the agent can load
148+
skills/ # All skills the agent can load
149149
docs/ # Long-form documentation (e.g. skill-cards.md)
150-
.claude-plugin/ # Claude Code marketplace manifest (defines the bundle)
151-
.cursor-plugin/ # Cursor marketplace manifest (generated mirror)
150+
.claude-plugin/ # Claude Code marketplace manifest
151+
.cursor-plugin/ # Cursor marketplace manifest
152152
plugin-metadata.json # Vendor-neutral identity/discovery metadata
153153
.github/workflows/ # CI for validating skills
154154
.github/scripts/ # Internal repo scripts
155155
.github/scripts/sources.yml # External skill sources for federation
156156
```
157157

158-
This repository is a [Claude Code plugin marketplace](https://code.claude.com/docs/en/plugin-marketplaces):
159-
`.claude-plugin/marketplace.json` at the root is the catalog, and it defines a
160-
single curated plugin (`amd-skills`) that bundles the published skills. The
161-
plugin's `source` is the repo root (`./`) with `strict: false`, and its `skills`
162-
array lists exactly which skill folders ship, as `./skills/<name>` paths:
163-
164-
```json
165-
{
166-
"name": "amd-skills",
167-
"source": "./",
168-
"strict": false,
169-
"skills": ["./skills/local-ai-use", "./skills/serving-llms-on-instinct", "..."]
170-
}
171-
```
172-
173-
Because the plugin ships the skill folders in place, nothing is duplicated and
174-
there is no generated plugin tree to keep in sync. `skills/` stays the single
175-
source of truth, and a skill that is not listed in the `skills` array simply
176-
stays unpublished. This is the "canonical catalog, curated publish" model: the
177-
catalog can grow freely while the published bundle stays deliberate.
178-
179158
In-repo skills are authored directly under `skills/`. Federated skills are
180159
declared in [`.github/scripts/sources.yml`](.github/scripts/sources.yml) and vendored into
181160
`skills/` by the manually-dispatched `import-external-skills` workflow,

0 commit comments

Comments
 (0)