Skip to content

Commit 8746496

Browse files
committed
Simplify instructions
1 parent 6d57b65 commit 8746496

1 file changed

Lines changed: 14 additions & 9 deletions

File tree

docs/federating-your-repo.md

Lines changed: 14 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -33,18 +33,23 @@ Use `as:` to namespace skills as `<project>-<skill>` so catalog names stay uniqu
3333

3434
## Import
3535

36-
1. Open a PR with your `sources.yml` change.
37-
2. Run the **Import external skills** workflow (manual dispatch). It shallow-clones
38-
your repo at `ref`, vendors the folders into `skills/<name>/`, writes a
39-
`.federated.json` marker (repo, ref, resolved commit, license, timestamp), and
40-
opens a PR with the result.
41-
3. A maintainer reviews and merges. CI validation must pass.
36+
Run the import scripts locally (they read `sources.yml` from your working tree),
37+
then open a PR for review.
38+
39+
1. Vendor the skills and refresh the manifests:
40+
41+
```bash
42+
uv run .github/scripts/import_external_skills.py # vendor into skills/<name>/
43+
uv run .github/scripts/generate_cursor_marketplace.py
44+
./.github/scripts/check.sh # validate
45+
```
46+
47+
2. Commit `skills/**`, `.github/scripts/sources.yml`, and the manifests.
48+
3. Open a PR; a maintainer reviews and merges once CI passes.
4249

4350
## Update or remove
4451

45-
- **Update:** bump `ref` in `sources.yml`, re-run the workflow. The marker records
46-
the new commit.
47-
- **Remove:** delete the entry and re-run; the importer prunes the vendored copy.
52+
Automatic refresh and pruning will soon be enabled through nightly workflows.
4853

4954
Never hand-edit vendored skills under `skills/`; changes must come from your repo
5055
via re-import, or they'll be overwritten.

0 commit comments

Comments
 (0)