dvy1987/agent-loom / .agents/skills/agent-loom-sync
agent-loom-sync
VerifiedSync library skills from an agent-loom upstream repo into this project's .agents/skills while preserving project-local and forked skills. Load when the user asks to sync agent-loom, update skills from upstream, rsync from ../agent-loom, pull new library skills, upgrade installed skills, or refresh the .agents folder without losing custom project skills. Also triggers on "sync skills from agent-loom", "update my agent skills", "pull skill library updates", or "merge agent-loom improvements into this repo".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.3 KB |
| references/examples.md | markdown | 1.9 KB |
| references/sync-policy.md | markdown | 1.5 KB |
| scripts/sync_agent_loom.py | script | 9.5 KB |
| templates/agent-loom-sync.json | config | 131 B |
references/examples.md
View on GitHub# Agent-Loom Sync — Examples
## Example 1 — First sync after copying .agents into a project
<input>sync skills from ../agent-loom — I copied .agents last month and want updates without losing my custom deploy skill</input>
<output>
**Sync plan** (dry-run)
Upstream: `/Users/me/Projects/agent-loom` @ `d148d27`
Add (12): knowledge-graph, agent-loom-sync, check_red_flags_quality, …
Update (8): validate-skills, improve-skills, memory-handoff, …
Unchanged (74): test-driven-development, …
Local-only protected (1): `my-deploy-pipeline`
**Protected automatically**
- `my-deploy-pipeline` — exists only in this repo (never deleted, never overwritten)
**Next:** Run with `--apply` after you confirm. Then `validate-skills` on changed skills.
Config will be written to `.agents/agent-loom-sync.json`.
</output>
## Example 2 — Protect a customized library skill (same name as upstream)
<input>I customized debug-and-fix for our stack — don't overwrite it on sync</input>
<output>
Add to `.agents/agent-loom-sync.json`:
```json
"forked_skills": {
"debug-and-fix": "Custom triage for Stripe webhooks — 2026-07-04"
}
```
Re-run dry-run — `debug-and-fix` moves to Forked/skipped. Other library skills still update.
**Note:** Repo-only skills get `metadata.origin: project-local` from `universal-skill-creator` at create time; `agent-loom-sync --apply` backfills any missing.
</output>
## Example 3 — Apply sync
<input>apply the sync</input>
<output>
```bash
python3 .agents/skills/agent-loom-sync/scripts/sync_agent_loom.py --apply
```
Applied: 20 skills
Config updated: `.agents/agent-loom-sync.json` (`last_sync`, `upstream_commit`)
**Post-sync**
- [ ] `validate-skills` on updated skills
- [ ] Commit `.agents/` + config with message `chore: sync agent-loom library @ d148d27`
- [ ] `memory-handoff` if ending session
Logged to `docs/skill-outputs/SKILL-OUTPUTS.md`.
</output>
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: 471k | 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 |