fzymgc-house-fzymgc-house-skills

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.

Skill	Description
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 [email protected]: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