convez.ai
SkillDevOps & InfraestruturaAvançado
fzymgc-house

fzymgc-house Skills

fzymgc-house/fzymgc-house-skills

Skills de DevOps, dev-flow e jj para clusters self-hosted

Ver no GitHub
InicialPluginScore · de 0 a 100

Suite 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-skills

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
37%
Último commit
há 1 semana
Versão
v2.0.1
Issues abertas
7
Contribuidores
4

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-curator has moved. The memory plugin now lives in seanb4t/engram as the engram bundled 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 under docs/.

Plugins

homelab

Infrastructure skills for interacting with the homelab cluster.

SkillDescription
grafanaGrafana, Loki, and Prometheus operations — dashboards, logs, metrics, alerting, incidents, OnCall, profiling
terraformTerraform Cloud operations — runs, workspaces, state management, registry documentation
skill-qaValidates SKILL.md files against Claude Code best practices

jj

Jujutsu workflow guidance for colocated and standalone repositories.

SkillDescription
jujutsuCore 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:

SkillDescription
using-superpowersEntry skill that enforces skill discovery and platform adaptation
brainstormingDesign workflow before implementation
writing-plans / executing-plansPlan-driven implementation workflow
systematic-debuggingStructured debugging workflow
verification-before-completionVerification 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.

SkillDescription
review-prDispatches up to 10 review agents in parallel, persists findings as beads
address-findingsFix loop with worktree-isolated fix-workers, merge protocol, and review gates
respond-to-commentsGitHub 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.

Ver o original no GitHub

Bom para

Relacionados