jj

fzymgc-house-skills

A Claude Code plugin marketplace for the fzymgc-house self-hosted cluster. Contains two plugins covering homelab infrastructure operations and automated PR review workflows.

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

pr-review

Automated PR review workflow using 12 specialized agents with git worktree isolation for parallel execution.

Skills (orchestrators):

Skill	Description
review-pr	Dispatches up to 9 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

Agents (dispatched by orchestrator skills):

Agent	Role
code-reviewer	Project guideline compliance and bug detection
silent-failure-hunter	Error handling and silent failure auditing
pr-test-analyzer	Test coverage quality and gap analysis
type-design-analyzer	Type invariant strength and encapsulation
comment-analyzer	Code comment accuracy and maintainability
security-auditor	OWASP-based security vulnerability detection
api-contract-checker	Breaking changes and backward compatibility
spec-compliance	Alignment with design docs and ADRs
code-simplifier	Clarity and maintainability improvements
fix-worker	Implements fixes in isolated worktrees
review-gate	Validates fixes address their findings
verification-runner	Runs quality gates after fixes are applied

Installation

claude plugin install github:fzymgc-house/fzymgc-house-skills

Or install individual plugins:

claude plugin install github:fzymgc-house/fzymgc-house-skills/homelab
claude plugin install github:fzymgc-house/fzymgc-house-skills/pr-review

Development

Prerequisites

• lefthook (git hooks)
• rumdl (markdown linting)
• cocogitto (conventional commit validation)
• ruff (Python linting/formatting)

Setup

git clone git@github.com:fzymgc-house/fzymgc-house-skills.git
cd fzymgc-house-skills
lefthook install

Repository Structure

.claude-plugin/
  marketplace.json      # Marketplace manifest listing both plugins
homelab/
  plugin.json           # Plugin manifest
  skills/
    grafana/            # Grafana/Loki/Prometheus operations
    terraform/          # Terraform Cloud operations
    skill-qa/           # SKILL.md validation
pr-review/
  plugin.json           # Plugin manifest
  agents/               # 12 agent definitions (YAML frontmatter + system prompt)
  skills/
    review-pr/          # Review orchestrator
    address-findings/   # Fix loop orchestrator
    respond-to-comments/  # PR comment management

Commits

All commits must follow Conventional Commits format. This is enforced by a commit-msg hook via cocogitto.

feat(grafana): add incident management support
fix(review-pr): correct agent dispatch for security aspect
docs: update README

Versioning

Versions are managed by release-please. Do not manually bump versions in marketplace.json, plugin.json, or SKILL.md files.

License

Private repository for fzymgc-house infrastructure.