Skip to content

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

soia-meta-sync-skills

Verified

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

references/source-rules.md

View on GitHub
# Source Rules

Use these rules for non-SOIA single-skill sync and for source classification before target confirmation.

## Local Directory

Recognize:

- Absolute paths: `/path/to/skill`
- Home paths: `~/path/to/skill`
- Relative paths: `./skill` or `../skill`

Rules:

- Resolve the path and verify it is a directory.
- Require `SKILL.md` directly inside the directory for single-skill sync.
- Derive the skill name from the directory basename unless the user explicitly supplies another name.
- Do not execute files from the source directory.

## GitHub Repository

Recognize:

- `https://github.com/org/repo`
- `https://github.com/org/repo.git`
- `git@github.com:org/repo.git`

Rules:

- Clone into a durable local source directory (see the boundary below), never a temporary one.
- Strip a trailing `.git` only for display/name derivation; keep the clone URL valid.
- Locate `SKILL.md`.
- If the repo root contains `SKILL.md`, use the repo root as the skill directory.
- If one nested `SKILL.md` exists, use its parent directory.
- If multiple nested `SKILL.md` files exist, ask the user which skill to sync.
- On failure, remove the partial clone.

## skillsmp.com Page

Recognize:

- URLs containing `skillsmp.com`.

Rules:

- Fetch or open the page only after confirming the user wants that remote source.
- Extract a skill directory containing `SKILL.md` plus any bundled resources.
- Preserve bundled `scripts/`, `references/`, and `assets/` when present.
- If extraction cannot produce a valid local directory with `SKILL.md`, stop and report the blocker.
- Do not run downloaded scripts during import.

## Single-Skill Link Boundary

For a single-skill sync, remove only `<target>/<skill-name>` before linking. Do not scan or clean other target entries.

The resolved source directory must remain available after sync. For remote sources, install through `npx skills add` or clone into a durable local source before creating agent symlinks; do not create symlinks to a temporary directory that will be deleted.
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated 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: 322kUpdated Claude CodeCodexVerifiedInstall