layered-soul/skills/README.md

# Layered Soul Skills

Cross-harness skills reviewed and imported from the private `hermes-soul` runtime backup. Each skill is a reusable procedure that works across Hermes, Colibri, Pi, Codex, Claude Code, and Zot.

## Included skills

| Skill | Category | Purpose |
|-------|----------|---------|
| forgejo-operations | devops | Manage self-hosted Forgejo — repos, users, PRs, branch protection |
| vaultwarden-secrets | devops | Self-hosted Vaultwarden + Bitwarden CLI for agent secrets |
| bootable-usb-images | devops | Download, verify, flash compressed bootable USB images |
| herdr-deployment | devops | Build, configure, deploy Herdr terminal workspace manager |
| colibri-development | software-dev | Develop in the Colibri Rust workspace — builds, tests, crates |
| systematic-debugging | software-dev | 4-phase root cause debugging methodology |
| test-driven-development | software-dev | TDD: RED-GREEN-REFACTOR cycle enforcement |
| codebase-knowledge-graphs | software-dev | Build/query persistent codebase knowledge graphs |
| vision-model-setup | mlops | Configure and troubleshoot vision capabilities across providers |

## Adding skills

Skills are curated from `hermes-soul/skills/` after operator review. Only skills that are useful across MULTIPLE harnesses belong here. Hermes-specific skills (cron management, Telegram gateway, voice setup) stay in `hermes-soul`.

To import a skill:
```sh
cp -r ~/hermes-soul/skills/<category>/<skill-name> ~/ai/layered-soul/skills/
```

Then validate:
```sh
python3 scripts/layered_soul.py validate .
```
Populate layered-soul: identity, memories, skills, plan (Hermes & Sam) - SOUL.md: full agent identity, operating principles, voice - IDENTITY.md: runtime identity, hosts, boundaries - USER.md: operator context imported from hermes-soul - AGENTS.md: actual operating rules, infrastructure, quick reference - memories/curated/: 5 topics (tailscale, forgejo, agents, projects, vaultwarden) - skills/: 9 cross-harness skills imported from hermes-soul after review - docs/PLAN-CONFIGURE-PRIVATE-REPO.md: configuration plan - Validate: passes clean 2026-06-14 00:21:26 +02:00			`# Layered Soul Skills`
Initial Layered Soul contract (Sam & Codex) Creates the cross-harness Layered Soul repository skeleton while keeping hermes-soul as the Hermes-native Debby Linux backup.\n\nChecks: npx --yes prettier@3 --write touched docs/manifests 2026-06-13 14:50:54 +02:00
Populate layered-soul: identity, memories, skills, plan (Hermes & Sam) - SOUL.md: full agent identity, operating principles, voice - IDENTITY.md: runtime identity, hosts, boundaries - USER.md: operator context imported from hermes-soul - AGENTS.md: actual operating rules, infrastructure, quick reference - memories/curated/: 5 topics (tailscale, forgejo, agents, projects, vaultwarden) - skills/: 9 cross-harness skills imported from hermes-soul after review - docs/PLAN-CONFIGURE-PRIVATE-REPO.md: configuration plan - Validate: passes clean 2026-06-14 00:21:26 +02:00			Cross-harness skills reviewed and imported from the private `hermes-soul` runtime backup. Each skill is a reusable procedure that works across Hermes, Colibri, Pi, Codex, Claude Code, and Zot.
Initial Layered Soul contract (Sam & Codex) Creates the cross-harness Layered Soul repository skeleton while keeping hermes-soul as the Hermes-native Debby Linux backup.\n\nChecks: npx --yes prettier@3 --write touched docs/manifests 2026-06-13 14:50:54 +02:00
Populate layered-soul: identity, memories, skills, plan (Hermes & Sam) - SOUL.md: full agent identity, operating principles, voice - IDENTITY.md: runtime identity, hosts, boundaries - USER.md: operator context imported from hermes-soul - AGENTS.md: actual operating rules, infrastructure, quick reference - memories/curated/: 5 topics (tailscale, forgejo, agents, projects, vaultwarden) - skills/: 9 cross-harness skills imported from hermes-soul after review - docs/PLAN-CONFIGURE-PRIVATE-REPO.md: configuration plan - Validate: passes clean 2026-06-14 00:21:26 +02:00			`## Included skills`

			`\| Skill \| Category \| Purpose \|`
			`\|-------\|----------\|---------\|`
			`\| forgejo-operations \| devops \| Manage self-hosted Forgejo — repos, users, PRs, branch protection \|`
			`\| vaultwarden-secrets \| devops \| Self-hosted Vaultwarden + Bitwarden CLI for agent secrets \|`
			`\| bootable-usb-images \| devops \| Download, verify, flash compressed bootable USB images \|`
			`\| herdr-deployment \| devops \| Build, configure, deploy Herdr terminal workspace manager \|`
			`\| colibri-development \| software-dev \| Develop in the Colibri Rust workspace — builds, tests, crates \|`
			`\| systematic-debugging \| software-dev \| 4-phase root cause debugging methodology \|`
			`\| test-driven-development \| software-dev \| TDD: RED-GREEN-REFACTOR cycle enforcement \|`
			`\| codebase-knowledge-graphs \| software-dev \| Build/query persistent codebase knowledge graphs \|`
			`\| vision-model-setup \| mlops \| Configure and troubleshoot vision capabilities across providers \|`

			`## Adding skills`

			Skills are curated from `hermes-soul/skills/` after operator review. Only skills that are useful across MULTIPLE harnesses belong here. Hermes-specific skills (cron management, Telegram gateway, voice setup) stay in `hermes-soul`.

			`To import a skill:`
			```sh
			`cp -r ~/hermes-soul/skills/<category>/<skill-name> ~/ai/layered-soul/skills/`
			```

			`Then validate:`
			```sh
			`python3 scripts/layered_soul.py validate .`
			```