Skip to content

dvy1987/agent-loom / .agents/skills/agent-loom-sync

agent-loom-sync

Verified

Sync 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".

FileKindSize
SKILL.mdskill md7.3 KB
references/examples.mdmarkdown1.9 KB
references/sync-policy.mdmarkdown1.5 KB
scripts/sync_agent_loom.pyscript9.5 KB
templates/agent-loom-sync.jsonconfig131 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>
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: 471kUpdated 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