soia-team/soia-open-skills / skills/soia-meta-sync-skills
soia-meta-sync-skills
Verified按明确范围把共享技能目录软链到项目或宿主,写入前先 dry-run。触发:技能同步、同步预览、把技能链到项目
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.1 KB |
| agents/openai.yaml | config | 262 B |
| assets/config.example.yml | config | 214 B |
| references/soia-managed-skills.md | markdown | 2.8 KB |
| references/source-rules.md | markdown | 2.0 KB |
| references/targets-and-confirmation.md | markdown | 3.6 KB |
| scripts/install_selection.py | script | 2.2 KB |
| scripts/sync_soia_skills.py | script | 34.7 KB |
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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |