AI Fabric

Public mirror of skills for reuse. Canon: eSlider/inventar (private Gitea). Sync skills from inventar.

This repository (branch main) deliberately contains no application code. The Go-based software-delivery fabric (cmd/, pkg/, internal/, Dockerfile, docker-compose, CI workflow) was stripped so this branch stays purely for decisions, workflows, and skills and their reuse across systems.

graph TD
  Fabric[ai-fabric main] --> S[skills/ catalog]
  Fabric --> D[decisions/ ADRs]
  Fabric --> W[workflows/ runbooks]
  S --> Sync[sync.sh]
  Sync --> Opencode[~/.config/opencode/skill/]
  Opencode --> Agents[openCode agents]
  Agents --> Fabric

Loading

What lives here

• decisions/ — Architecture Decision Records (ADRs) and accepted plans. Read decisions/README.md for the ADR format.
• workflows/ — reusable process runbooks (CI/CD, issue-handler, PR best-practices, monitoring, backup-restore, e2e-poc-validation, python-to-go-migration). Read workflows/README.md.
• skills/ — the consolidated skill catalog. Each skill is a subdir with a SKILL.md (+ aux files) and opencode-compatible frontmatter (name:/description:). Read skills/README.md. This showcase carries generic, reusable skills only; host-specific skills (internal hosts, paths, domain tooling) live exclusively in the private canon eSlider/inventar (docs/skills/).
• sync.sh — idempotent installer that distributes all skills from skills/ into a target opencode skills directory.
• AGENTS.md — agent-facing guide to this repo.

Using skills across systems

Skills are portable and installed by sync.sh. It copies every skill subdir under skills/ into ~/.config/opencode/skill/<name>/ (override with --target), creating dirs as needed and mirroring deletions via rsync --delete.

# preview what would change, write nothing
./sync.sh --dry-run

# install / refresh all skills into the default target
./sync.sh

# install into a custom directory
./sync.sh --target /some/other/skills

sync.sh is idempotent — safe to run any time. Use --dry-run first to confirm the change set. It logs each skill it syncs.

Installing skills

Skills are updated only in the canon (eSlider/inventar, private Gitea), never in their installed locations. ai-fabric mirrors the canon; to distribute locally:

1. Sync the skill in the canon (inventar/docs/skills/<name>/).
2. Mirror it into skills/ here.
3. Run ./sync.sh to propagate.

Removing a skill from the catalog also removes it from the target on the next sync.sh.

Core use cases

• Consolidated skills: one public catalog, no duplicate skills across repos (dedup decisions recorded in skills/README.md).
• Portable workflows & decisions: runbooks and ADRs that any project or system can adopt.
• Reuse across systems: sync.sh pushes the catalog into any opencode installation, making every agent see the same skills.

Repository layout

AGENTS.md                 agent guide
README.md                 this file
CODEOWNERS                ownership policy
.gitignore / .ignore      hygiene
decisions/                ADRs, accepted plans, reference sources
workflows/                process runbooks
skills/                   single consolidated skill catalog
sync.sh                   skill distribution script