Shared agent skills and configurations across Grok Bot, Grok Build, Claude Code, and other platforms.
  • Python 74.5%
  • Go Template 19.2%
  • Shell 3.2%
  • Jinja 3.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Grok 70f74c336a Map Sivili (Civilian) seat as host-only
No portable civics role fits yet; charter stays on Grok/grokbot seats.
2026-11-05 18:27:48 -08:00
agents docs: curate portable standards; add secrets + clean-merged-branches 2026-09-06 16:57:39 +00:00
configs Map Sivili (Civilian) seat as host-only 2026-11-05 18:27:48 -08:00
design docs: rename Design and Video seats 2026-10-03 12:47:48 -07:00
docs docs: record loopcamp as an off-LAN agent site 2026-09-28 18:11:33 -07:00
overlays docs(ansible): never use tags: always 2026-10-03 08:52:41 -07:00
skills fix(homelab-wiki): per-host tokens via X-DokuWiki-Token, password-file unlock 2026-10-03 16:19:31 -07:00
standards tools: add with-secrets loader; standards: secrets-handling 2026-10-03 11:07:08 -07:00
tools tools: add with-secrets loader; standards: secrets-handling 2026-10-03 11:07:08 -07:00
.gitignore feat: add vaultwarden-bw skill for bw CLI access checks 2026-09-17 07:53:04 -07:00
AGENTS.md docs: record loopcamp as an off-LAN agent site 2026-09-28 18:11:33 -07:00
README.md docs: rename Design and Video seats 2026-10-03 12:47:48 -07:00

agents

Shared standards, skills, and agent configurations for use across platforms:

  • Claude Code
  • Grok (project agents; Grok Bot and Grok Build for host wiring)
  • Cursor (and similar)

This repo is the source of truth for portable agent behavior. Platform-specific wiring lives under configs/; reusable multi-step recipes live under skills/.

Layout

Path Purpose
standards/ Norms stated once, cited by everything else. Start here.
agents/ Portable role contracts — what an agent is for, with no stack or project detail
overlays/ Stack rules (Godot, Python/Qt). Platform-independent; appended to a role
skills/ Portable skill packs (SKILL.md + helpers), with a bindings table for host paths
tools/ Small standalone helpers agents install on hosts (e.g. with-secrets)
configs/claude-code/ .claude/ frontmatter dialect, permission grant sets
configs/grok/ .grok/agents/ frontmatter dialect, two-role mapping
configs/grok-bot/, configs/grok-build/ Bot seat mapping / Build session wiring onto agents+overlays
configs/cursor/ Cursor rules and conventions
configs/_shared/ Org forge URLs, token env names, label taxonomy
docs/ How to consume and publish shared agents
design/ Visual language packs (homelab apps, etc.); Desi (Design seat) owns; AppDev and Webby (Web seat) cite

How the pieces combine

An agent file in a consuming repository is four parts: host frontmatter, a role contract, a stack overlay, and a short project block naming that repository's documents and known state. See docs/composition.md.

Rules

  • No secrets, tokens, or passwords in this repo. Point at secret stores by name only.
  • Keep skills and roles generic; put host-specific paths and IDs in configs/<platform>/, and project-specific state in the consuming repository.
  • Cite a standard, never transcribe it. A transcribed norm is a copy that will drift — the label taxonomy reached five hand-written copies before this repo existed.
  • Prefer small, composable pieces over one mega-prompt.
  • Document the consumer: which file each platform should load.
  • Sessions on the loopcamp host follow configs/_shared/loopcamp.md. Home-LAN and Grok Bot sessions keep the endpoints in configs/_shared/forge-org.md.

Quick start

  1. Clone this repo (or add it as a submodule / worktree) where your agent host can read it.
  2. Read configs/<platform>/README.md for that host's frontmatter dialect and load paths.
  3. Compose each agent from agents/ + overlays/ + your project block, per docs/composition.md.
  4. Copy or symlink the skills you need from skills/ (including clean-merged-branches/), and fill in their bindings tables.
  5. Cite standards/secrets-and-credentials.md; never commit tokens. Claude grant sets: apply by hand from configs/claude-code/settings-permissions.md. Org forge facts: configs/_shared/.