skills.rest
DojoGenesis
DojoGenesisCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

semantic-clusters

Generate a markdown behavioral architecture map grouping code components by action-verb clusters.

2|Updated Apr 8, 2026
Search Tags:#architecture#analysis#system-health#semantic#clustering#gap-detection#verb-mapping
One-click install
npx skills add https://github.com/DojoGenesis/gateway --skill semantic-clusters
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: semantic-clusters
Source: https://github.com/DojoGenesis/gateway/tree/main/plugins/system-health/skills/semantic-clusters
Command: npx skills add https://github.com/DojoGenesis/gateway --skill semantic-clusters

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Understanding a codebase’s capabilities is hard when only the filesystem layout is visible, leading to missed functionality, hidden gaps, and confusing architectural decisions.

Core Features & Use Cases

  • Behavioral Architecture Map: Generates a markdown map that groups every significant component by action‑verb clusters, revealing what the system can do.
  • Cross‑Cluster Insight: Identifies components that belong to multiple clusters, highlighting integration points and architectural concerns.
  • Orphan Detection & Health Assessment: Flags directories not represented in any cluster and provides health emojis with concise audit notes.
  • Use Cases: Quickly onboard new engineers, plan refactors, audit feature coverage, or create status documents that focus on system behavior rather than file locations.

Quick Start

Generate a semantic cluster map for the repository at /path/to/repo.

Frequently Asked Questions about semantic-clusters

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

FAQPage Schema
How do I map codebase capabilities by grouping components into action-verb clusters?▼

Behavioral architecture mapping groups code components by action-verb clusters to reveal system capabilities. You provide a repository path, and the tool outputs a markdown map with component tables, health assessments, and cross-cluster listings.

What is semantic clustering for system behavior analysis?▼

Semantic clustering for system behavior analysis groups codebase components by the actions they perform rather than file locations. This approach reveals hidden functionality, capability gaps, and cross-cutting concerns for architectural planning and documentation.

How do I detect orphan directories and assess codebase health during architecture analysis?▼

Architecture analysis tools detect orphan directories by flagging code paths not represented in any behavioral cluster. Health assessments provide concise audit notes with health emojis to highlight architectural concerns and integration points.

Can I use behavioral architecture mapping to onboard new engineers and plan refactors?▼

Behavioral architecture mapping accelerates engineer onboarding and refactor planning by focusing on system behavior rather than file locations. It generates status documents showing capabilities, gaps, and cross-cutting concerns for any repository.

Does semantic clustering require specific dependencies or framework support to analyze a repository?▼

Semantic clustering requires only a repository path input to analyze a codebase. It operates without external dependencies, applying verb-mapping and gap-detection directly to the codebase to produce a markdown architecture map.

What is the best way to visualize cross-cluster integration points in a codebase?▼

Visualizing cross-cluster integration points is best achieved by generating a markdown map that identifies components belonging to multiple action-verb clusters. This highlights overlapping capabilities and architectural concerns across the system.

Related Skills

Explore More Software Engineering Skills→
tense-itense-i
1

repo-architecture-analyst

Analyze local code repositories to extract core scenes and architectural solutions.

Community
Advanced
matteocervellimatteocervelli
25

planning-doc-generator

Generate project assessment Markdown reports from structured JSON data.

Community
Intermediate
radenadriradenadri

architecture-audit

Audit codebases against claimed architecture to identify drift and cohesion issues.

Community
Advanced
cill-i-amcill-i-am

virtual-file-routes

Build programmatic route trees with TanStack Router helpers.

Community
Intermediate