Skip to content

soia-team/soia-open-skills / skills/soia-meta-sync-skills

soia-meta-sync-skills

Verified

按明确范围把共享技能目录软链到项目或宿主,写入前先 dry-run。触发:技能同步、同步预览、把技能链到项目

references/soia-managed-skills.md

View on GitHub
# SOIA Managed Skills

Use this reference for SOIA batch sync from a repository-local preflight source or from the npx-installed shared source.

## Current Managed Set

The batch script discovers current managed skills mechanically:

- Include every directory under the selected source that contains `SKILL.md` and starts with `soia-`.
- Include optional non-SOIA entries only when the user selects optional sync or the script is run with `--optional`.
- Exclude support files and nested helper directories that do not contain their own `SKILL.md`.

Adding a new `soia-*` skill needs only its folder; several packages installed into one shared source produce one complete target set.

## Included SOIA Domains

Development:

- `soia-dev-*`

Design:

- `soia-design-*`

Meta:

- `soia-meta-*`

Other domains (`soia-media-*`, `soia-cwork-*`, and the remaining private `soia-corp-*` skill) are discovered the same way when they are present in the selected source.

Public PKM:

- `soia-pkm-*` (published by `soia-open-skills`, linked by this script after npx installs it into the shared source)

## Optional Set

Optional skills are linked only when the user selects optional sync or the script is run with `--optional`.

No optional entries are currently bundled.

## Retired Cleanup Names

Retired names are removed from target agent directories during SOIA batch sync. The authoritative list is `RETIRED_SKILLS` in `scripts/sync_soia_skills.py`; add a name there when a skill is removed, renamed, merged, or its repository is retired.

The 2026-11-11 reduction added 55 names in one batch: all 18 skills of the retired env domain, 4 dev skills, 4 merged-away names (`soia-dev-agent-md-advisor`, `soia-media-publish-x-article`, `soia-media-publish-x-thread`, `soia-cwork-feishu-doc-git-sync`), 2 edu skills, `soia-meta-publish-market`, 8 corp skills, and all 18 skills of the retired and deleted private repository (`soia-gov-*`, its workspace `soia-design-*` / `soia-dev-*` entries, `soia-meta-harness`). The list in the script stays the only place that spells them out.

## Cleanup Boundary

- Managed current set = discovered `soia-*` skills plus optional entries when selected.
- Repository ownership and target-link ownership are separate: `soia-open-skills` publishes `soia-pkm-*`; this script may link those installed shared-source directories without editing their contents.
- Managed retired set = `RETIRED_SKILLS` in the sync script.
- Overwrite only current managed skill names selected for this run.
- Delete explicit retired cleanup names and first-level dangling symlinks whose names start with `soia-`.
- Keep dangling symlinks when `--no-prune` is selected.
- Never delete or rewrite unrelated target entries such as user skills or third-party skills not selected here.
- Target entries must be symlinks to the selected source. Do not copy managed skill directories into multiple agent homes.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall