modular-skills-architect

Map agent context ecosystems and generate refactoring plans for skills, commands, and workflows.

5|Updated Oct 22, 2025
One-click install
npx skills add https://github.com/marchatton/agent-skills --skill modular-skills-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: modular-skills-architect
Source: https://github.com/marchatton/agent-skills/tree/main/.agents/skills/98-skill-maintenance/modular-skills-architect
Command: npx skills add https://github.com/marchatton/agent-skills --skill modular-skills-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill tackles the complexity of managing interconnected agent skills, commands, and documentation, providing a clear roadmap for organization and improvement.

Core Features & Use Cases

  • System Mapping: Visualizes the relationships and dependencies within your agent's ecosystem.
  • Refactoring Plan: Generates concrete steps to split, consolidate, rename, or delete components for better maintainability.
  • Use Case: When your agent's skills and commands become tangled and difficult to understand, use this Skill to untangle them, define clear ownership, and create a more robust architecture.

Quick Start

Use the modular-skills-architect skill to analyze the current agent ecosystem and propose a refactoring plan.

Frequently Asked Questions about modular-skills-architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I refactor a tangled agent ecosystem with overlapping skills and commands?

To refactor an agent ecosystem, you must first map dependencies between skills, commands, and documentation to generate an actionable plan. This approach outputs concrete steps to split, consolidate, rename, or delete components for better maintainability and clear ownership.

What is agent ecosystem mapping and when do I need it?

Agent ecosystem mapping visualizes the relationships and dependencies across your agent's skills, commands, workflows, and hooks. You need it when components become difficult to understand, allowing you to untangle them and establish a more robust architecture.

How do I consolidate or split agent skills and workflows?

To consolidate or split agent skills and workflows, generate a refactoring plan that analyzes routing and ownership consistency. This yields a module design specifying which components to merge, separate, rename, or delete for optimal architecture.

Can I fix agent routing and ownership consistency issues across documentation?

Yes, you can fix agent routing and ownership consistency issues by mapping the context ecosystem across agent files and documentation. This identifies inconsistencies and produces a targeted refactoring plan to resolve component ownership conflicts.

What is the best way to visualize dependencies between agent commands and hooks?

The best way to visualize dependencies between agent commands and hooks is through system mapping. This process diagrams the interconnected context ecosystem, revealing structural relationships so you can define clear ownership and improve routing.

Why does my agent architecture have inconsistent component ownership and routing?

Inconsistent component ownership and routing in agent architecture happens when interconnected skills, commands, and documentation grow without centralized mapping. Addressing this requires an ecosystem analysis to untangle dependencies and define clear ownership boundaries.