Skip to content
Skillpedia
General coding48k · #2197

architecture-review

Helps your agent analyze the structure of a software project. It can explain how parts connect and identify architectural risks.

What it does

This tool analyzes the structure of a software project. It helps understand how code parts connect, who owns which sections, and potential architectural risks.

When to use it

  • ✓When you want to understand the overall organization of a project.
  • ✓When you need to know which code parts depend on each other.
  • ✓When you want to identify potential issues in how the project is built.

Example of what to ask your AI

“Explain the architecture of this project.”

Want more? Open the sections below.

How to use

The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.

Skill link

https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/architecture-review/SKILL.md

Ready-to-paste message

Use this skill to help me: https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/architecture-review/SKILL.md Read the SKILL.md file at that link and follow its instructions for my task.
How it works

The tool uses a system called Ontoly to examine the code and its connections. It checks architecture rules and dependencies between modules.

Installation

Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.

In the terminal (Claude Code, Codex, Cursor), in your project folder:

npx skills add sickn33/agentic-awesome-skills --skill architecture-review

Or download just the file:

curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/architecture-review/SKILL.md -o SKILL.md
Technical content (original SKILL.md)

Original text by the author, straight from GitHub.

When to Use

  • Use when this upstream workflow matches the user's stated goal.
  • Use when the task requires the procedures documented in this skill.

Architecture Review

Use this skill when the user asks for architecture review using Ontoly evidence.

Required Workflow

Follow the shared Ontoly workflow. Read the graph evidence rules, MCP usage, best practices, and fallback rules when the task requires detail.

Ontoly Capabilities

Use these capabilities first: ExplainArchitecture, GraphStatistics, FindCycles, FindDependencies, EvidencePack.

Output Contract

Return:

  • answer or plan
  • capabilities invoked
  • graph evidence with node ids, edge types, source spans, and graph hash when available
  • confidence: high, medium, or low
  • fallback reason if repository files were inspected

Boundaries

Do not implement compiler, query, MCP, SDK, or business logic in the skill. Do not search repository files until Ontoly cannot answer or evidence must be confirmed.

Resources

Learn more

Examples

User: Apply this skill to my current task.
Assistant: Follow the workflow in this skill, cite limitations, and ask before risky steps.

Limitations

  • Imported upstream skill; verify credentials, permissions, and safety boundaries before execution.
  • Does not replace environment-specific validation, testing, or maintainer review.
FAQ

What is Ontoly?

Ontoly is a system that helps analyze the structure and connections within a software project.

What are 'module boundaries'?

These are the clear divisions between different parts or functionalities of a project's code.

What is 'package topology'?

This refers to how files and folders (packages) are organized within a project.

Details

Original description by the author

Review repository architecture using Ontoly Software Graph and MCP capabilities. Use when asked to explain architecture, module boundaries, package topology, service ownership, or architectural risk.

repo: sickn33/agentic-awesome-skills

Popularity

GitHub stars
48k
Ranking position
#2197
License
MIT
Updated
10/15/2026

Is this skill useful?

0

Sign in to vote.

Comments

  • …

More skills from this repository

Similar skills