fzymgc-house Skills
fzymgc-house/fzymgc-house-skills
Skills de DevOps, dev-flow e jj para clusters self-hosted
Ver no GitHubSuite de skills para Claude Code com foco em operações de homelab, workflow de desenvolvimento e controle de versão com jj. Inclui integrações para Grafana, Terraform, debugging estruturado e revisão automática de PRs com agentes paralelos.
Instalação
npx convez-ai fzymgc-house/fzymgc-house-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Operações de infraestrutura em homelab com Grafana e Prometheus
- Workflow de desenvolvimento plan-driven com debugging estruturado
- Revisão automática de PRs com múltiplos agentes especializados em paralelo
- Integração com Jujutsu para colocated e standalone repositories
Veredito

Ferramenta robusta e bem estruturada para equipes que rodam clusters self-hosted com Claude Code. Excelente para automatizar PR reviews e padronizar workflows de desenvolvimento, mas requer infraestrutura estabelecida e conhecimento técnico profundo.
README
A tradução para o português deste README ainda está na fila.
fzymgc-house-skills
A Claude Code plugin marketplace for the fzymgc-house self-hosted cluster. It currently ships three plugins: homelab operations, jj workflow guidance, and a development-flow workflow suite (originally forked from obra/superpowers, evolved independently). The repo now also includes a repo-local Codex marketplace that wraps the same skill content for Codex.
memory-curatorhas moved. The memory plugin now lives in seanb4t/engram as theengrambundled skill-plugin, co-located with the memory MCP server it drives. Install it via/plugin marketplace add seanb4t/engram→/plugin install engram. Its design history (spec/plan/ADRs) remains in this repo underdocs/.
Plugins
homelab
Infrastructure skills for interacting with the homelab cluster.
| Skill | Description |
|---|---|
| grafana | Grafana, Loki, and Prometheus operations — dashboards, logs, metrics, alerting, incidents, OnCall, profiling |
| terraform | Terraform Cloud operations — runs, workspaces, state management, registry documentation |
| skill-qa | Validates SKILL.md files against Claude Code best practices |
jj
Jujutsu workflow guidance for colocated and standalone repositories.
| Skill | Description |
|---|---|
| jujutsu | Core jj workflows, git interop, bookmarks, and workspace guidance |
dev-flow
Development workflow skills with git and jj support. Originally derived from obra/superpowers v5.0.7 and evolved independently for this repository (first-class jj support, bead integration, ADR capture).
Highlights:
| Skill | Description |
|---|---|
| using-superpowers | Entry skill that enforces skill discovery and platform adaptation |
| brainstorming | Design workflow before implementation |
| writing-plans / executing-plans | Plan-driven implementation workflow |
| systematic-debugging | Structured debugging workflow |
| verification-before-completion | Verification gate before claiming success |
See dev-flow/skills/ for the complete skill
list — additional skills cover worktrees, parallel agents, code review,
TDD, and skill authoring.
PR review workflow
dev-flow also includes an automated PR review workflow using specialized agents with worktree isolation for parallel execution.
| Skill | Description |
|---|---|
| review-pr | Dispatches up to 10 review agents in parallel, persists findings as beads |
| address-findings | Fix loop with worktree-isolated fix-workers, merge protocol, and review gates |
| respond-to-comments | GitHub PR comment management with bead-aware context |
Review/fix agents (dispatched by the orchestrators): code-reviewer,
silent-failure-hunter, pr-test-analyzer, type-design-analyzer,
comment-analyzer, security-auditor, api-contract-checker,
spec-compliance, code-simplifier, slop-hunter, fix-worker,
review-gate, verification-runner.
Installation
Claude Code
Add the marketplace, then install plugins by name:
claude plugin marketplace add fzymgc-house/fzymgc-house-skills
claude plugin install homelab@fzymgc-house-skills
claude plugin install jj@fzymgc-house-skills
claude plugin install dev-flow@fzymgc-house-skills
Codex
Use the repo-local Codex marketplace at
.agents/plugins/marketplace.json. The plugins/ directory contains thin
Codex wrappers that symlink back to the existing homelab/, jj/, and
dev-flow/ directories so the underlying SKILL.md content remains
single-source.
Current Codex limitation: named Claude plugin agents are not installed
natively. The dev-flow review workflows still work in Codex,
but agent-dispatch steps must follow the compatibility guidance in
dev-flow/skills/using-superpowers/references/codex-tools.md.
Development
Prerequisites
- Task (task runner — wraps the quality gates)
- rumdl (markdown linting)
- ruff (Python linting/formatting)
- uv (runs the Python test suites)
Setup
git clone git@github.com:fzymgc-house/fzymgc-house-skills.git
cd fzymgc-house-skills
# There is no pre-commit hook manager — jj does not fire git hooks reliably.
# Run the gates manually (the same tasks CI runs):
task fmt # auto-format markdown + Python before committing
task lint # markdown, Python, JSON, evals, ADR gates
task test # all harness-independent test suites
Repo-wide agent guidance lives in AGENTS.md. CLAUDE.md remains in the
repo as a Claude-specific addendum and compatibility shim.
Repository Structure
AGENTS.md
... # Canonical cross-platform agent instructions
CLAUDE.md
... # Claude-specific addendum and compatibility shim
.claude-plugin/
marketplace.json # Claude marketplace manifest listing the source plugins
.agents/plugins/
marketplace.json # Codex marketplace manifest listing wrapper plugins
plugins/
<plugin-name>/
.codex-plugin/plugin.json # Codex wrapper manifest
...symlinks into source plugin content
homelab/
plugin.json # Plugin manifest
skills/
grafana/ # Grafana/Loki/Prometheus operations
terraform/ # Terraform Cloud operations
skill-qa/ # SKILL.md validation
jj/
plugin.json # Plugin manifest
skills/
jujutsu/ # Jujutsu workflow guidance
dev-flow/
plugin.json # Plugin manifest
agents/ # workflow + review/fix/verification agents
skills/
review-pr/ # Review orchestrator
address-findings/ # Fix loop orchestrator
respond-to-comments/ # PR comment management
... # Workflow skills (originally from obra/superpowers v5.0.7)
Commits
All commits must follow Conventional Commits
format, validated in CI by the commit-lint workflow
(amannn/action-semantic-pull-request).
The repo squash-merges, so the PR title is the commit that lands on main.
feat(grafana): add incident management support
fix(review-pr): correct agent dispatch for security aspect
docs: update README
Versioning
Releases are managed by release-please:
merging conventional-commit PRs maintains a release PR that bumps a single
repo-wide version (.release-please-manifest.json, the plugin/marketplace
$.version fields, and CHANGELOG.md); merging it cuts the vX.Y.Z tag and
GitHub Release. Claude Code and Codex resolve installs by git commit SHA — the
in-file version fields and tag are human-facing markers, kept in sync by
release-please. See the "Release Versioning" section in AGENTS.md.
License
Private repository for fzymgc-house infrastructure.