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`

docs: apply Prettier to current markdown (Sam & Codex) Normalize markdown formatting after the latest main updates.\n\nChecks: python3 scripts/layered_soul.py validate .; npx --yes prettier@3 --check '*/.md'; git diff --check. 2026-06-14 01:48:32 +02:00			`\| 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 \|`
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
			`## 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:`
docs: apply Prettier to current markdown (Sam & Codex) Normalize markdown formatting after the latest main updates.\n\nChecks: python3 scripts/layered_soul.py validate .; npx --yes prettier@3 --check '*/.md'; git diff --check. 2026-06-14 01:48:32 +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			```sh
			`cp -r ~/hermes-soul/skills/<category>/<skill-name> ~/ai/layered-soul/skills/`
			```

			`Then validate:`
docs: apply Prettier to current markdown (Sam & Codex) Normalize markdown formatting after the latest main updates.\n\nChecks: python3 scripts/layered_soul.py validate .; npx --yes prettier@3 --check '*/.md'; git diff --check. 2026-06-14 01:48:32 +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			```sh
			`python3 scripts/layered_soul.py validate .`
			```