improve-codebase-architecture

Engineering Community
Interpretation is structured for decision-making; original keeps the upstream SKILL.md unchanged.

Decide Fit First

  • Core job: Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick. Su…
  • Best fit: Use it when the task has reusable inputs, steps, and validation criteria rather than a one-off answer.
  • Avoid forcing it: If the source lacks commands, platform support, or external-service evidence, keep those fields unknown instead of guessing.

Design Intent

  • Structure: The skill is organized around “Process”, “1. Explore”, “2. Present candidates as an HTML report”, “3. Grilling loop”, showing how the author expects the agent to judge fit, collect context, and produce verifiable output.
  • Trigger evidence: Prioritize the author’s wording around when to use it, what context to collect, and what output shape to produce.
  • Evidence boundary: Author text states facts, repository files prove commands and paths, and Fluxly only adds fit, limits, and usage judgment.

How To Use It

  • Inputs: Provide target material, scope, expected result, forbidden changes, and validation method.
  • Invocation: Name improve-codebase-architecture directly; if the source includes slash commands, start with the command and then add task context.
  • Validation: Start small and check whether the result follows “Process / 1. Explore / 2. Present candidates as an HTML report” before expanding.

Boundaries And Review

  • Dependencies: It usually needs no extra API key, so start with a small validation task.
  • Permissions: Declared permissions include read / write / shell-exec; ask the agent to state file, command, and rollback boundaries before acting.
  • Quality bar: A useful result names the deliverable, evidence, and next action. Generic prose means the task needs tighter context.
Fluxly profile Author and license come from source; runtime, permissions, and network are Fluxly detections or estimates
Fluxly category
Engineering
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
88 / 100 · heuristic scan, not runtime safety proof
Author / version / license
@mattpocock · no license declared
Fluxly token estimate
Lean
Fluxly setup estimate
Guided setup
External API key
No requirement detected
Detected OS requirements
macOS · Linux · Windows
Runtime requirements
Unspecified
Detected file/system behavior
  • Read-only
  • Write / modify
  • Shell exec
Detected network behavior
Local-only
Install commands
None (reference only)

Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.

Heads up: 未限定 allowed-tools,默认拥有全部工具权限。

Output preview improve-codebase-architecture.preview
The current SKILL.md does not define a fixed output example.

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.