improve-codebase-architecture

improve-codebase-architecture17 wordsCuratedinstall-now-after-trust-gate

Product-engineering workflow skills beyond the curated `obsidian-vault` row.

Quick Start

Install:

npx skills add mattpocock/skills --skill grill-me --skill tdd --skill to-prd --skill improve-codebase-architecture -y -g -a antigravity claude-code codex crush cursor gemini-cli github-copilot grok opencode

Use: /improve-codebase-architecture

Works with Claude Code, Gemini CLI, OpenCode, and other agentskills.io-compatible agents.

Curated external (hand-maintained)

Composed compose-external-wave-6 using authoring SSOT (docs/src/authoring/skills/improve-codebase-architecture.mdx) + research. Do not run wagents docs generate on this file (HAND-MAINTAINED sentinel). Run external-skill-auditor before using in production or promoting.

What It Does

From mattpocock/skills (MIT, 131k stars, respected TS educator Matt Pocock). Engineering: find deepening opportunities, informed by CONTEXT.md/ADRs; rescue ball-of-mud codebases. Run periodically. Part of composable engineering/productivity skills for real (non-vibe) engineering with agents. Setup skill recommended first. Small, adaptable, feedback-loop focused.

Harness Coverage

Targets verified harnesses: antigravity, claude-code, codex, crush, cursor, gemini-cli, github-copilot, grok, opencode.

Portable multi-harness install command:

npx skills add mattpocock/skills --skill grill-me --skill tdd --skill to-prd --skill improve-codebase-architecture -y -g -a antigravity claude-code codex crush cursor gemini-cli github-copilot grok opencode

Trust / Audit

Trust tier: Curated (curated-trust-gated)

Curated status: install-now-after-trust-gate

Risk notes: Product-engineering workflow skills beyond the curated obsidian-vault row.

Entry maintained via authoring + research for compose-external-wave-6; provenance and audit notes are authoritative there (research context is advisory).

Install Prerequisites

npx skills add mattpocock/skills —skill improve-codebase-architecture -y -g -a [agents]; often with setup-matt-pocock-skills; status=install-now-after-trust-gate.

Public Metadata

Field	Value
Source Type	curated-external
Display Source	mattpocock/skills
Source Kind	github
Installability	portable command
Review State	curated
Trust Tier	curated-trust-gated
Target Agents	antigravity, claude-code, codex, crush, cursor, gemini-cli, github-copilot, grok, opencode

General

Field	Value
Name	improve-codebase-architecture

Curated catalog entry

docs/src/authoring/skills/improve-codebase-architecture.mdx (full SSOT excerpt)

---
name: "improve-codebase-architecture"
description: "Product-engineering workflow skills beyond the curated `obsidian-vault` row."
title: "Improve Codebase Architecture"
source_kind: "curated-external"
source: "mattpocock/skills"
install_source: "mattpocock/skills"
status: "install-now-after-trust-gate"
trust_tier: "curated-trust-gated"
provenance_status: "verified-install-command"
install_command: "npx skills add mattpocock/skills --skill grill-me --skill tdd --skill to-prd --skill improve-codebase-architecture -y -g -a antigravity claude-code codex crush cursor gemini-cli github-copilot grok opencode"
target_agents: [antigravity, claude-code, codex, crush, cursor, gemini-cli, github-copilot, grok, opencode]
source_url: "https://github.com/mattpocock/skills"
notes: "Product-engineering workflow skills beyond the curated `obsidian-vault` row."
risk_notes: "Product-engineering workflow skills beyond the curated `obsidian-vault` row."
promotion_policy: "Install only after trust gate; audit again before repo promotion."
provenance_evidence: "Curated `npx skills add` command with named `--skill` selectors under `install-now-after-trust-gate` in config/external-skills.md."
---

{/* GENERATED-AUTHORING: source=config/external-skills.md; entry=improve-codebase-architecture; re-run migration to refresh */}

Product-engineering workflow skills beyond the curated `obsidian-vault` row.

Install / provenance (from authoring frontmatter + research):

Field	Value
install_command	npx skills add mattpocock/skills --skill grill-me --skill tdd --skill to-prd --skill improve-codebase-architecture -y -g -a antigravity claude-code codex crush cursor gemini-cli github-copilot grok opencode
source	mattpocock/skills
source_url	https://github.com/mattpocock/skills
trust_tier	curated-trust-gated
curated_status	install-now-after-trust-gate
target_agents	antigravity, claude-code, codex, crush, cursor, gemini-cli, github-copilot, grok, opencode

Resources

Skill Catalog Browse custom and external skills.

CLI Reference Install and manage skills.