analyze

Performs read-only repository analysis and returns ranked explanations with evidence and confidence levels.

Updated Feb 1, 2024
One-click install
npx skills add https://github.com/ogiboy/portfolio-app --skill analyze-ogiboy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: analyze
Source: https://github.com/ogiboy/portfolio-app/tree/main/.codex/skills/analyze
Command: npx skills add https://github.com/ogiboy/portfolio-app --skill analyze-ogiboy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When you need to understand why a codebase behaves a certain way, how a feature is wired across modules, or what likely caused a regression, ad-hoc guessing wastes time. This Skill performs grounded, read-only repository analysis and returns a ranked synthesis that clearly separates evidence from inference. ## Core Features & Use Cases - Ranked Synthesis: Competing explanations are compared and ranked by strength of supporting evidence, each with an explicit confidence level. - Evidence vs Inference Boundaries: Every claim is labeled as direct evidence (with concrete file references), inference, or unknown, so nothing is overclaimed. - Parallel Exploration Lanes: For complex questions, bounded parallel lanes inspect code paths, configuration, and tests independently before synthesis. - Use Case: Ask why a CI workflow fails only on release branches, and receive a ranked table of explanations backed by specific file and line references, plus a list of what the repository cannot resolve. ## Quick Start Ask the agent to analyze why a specific behavior occurs in the repository, for example: analyze why the build fails on the Turbopack path.

Frequently Asked Questions about analyze

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

FAQPage Schema
How do I get a grounded explanation of why code behaves a certain way?▼

Invoke the analyze skill with your question, such as why a workflow fails or how a feature is wired. It reads the relevant files, ranks competing explanations by evidence strength, and returns a synthesis with concrete file references and confidence levels.

What is the difference between evidence and inference in code analysis?▼

Evidence is a claim directly supported by repository artifacts like code, tests, or configs with file references. Inference is a reasoned conclusion drawn from that evidence. This skill labels every material claim as evidence, inference, or unknown so nothing is overclaimed.

Can the analyze skill modify or fix my code?▼

No. The skill is read-only by contract and never edits files or produces implementation plans. If a next step is needed, it only suggests a discriminating read-only probe that would reduce uncertainty.

When should I not use read-only repository analysis?▼

Skip it when you explicitly want code edits or fixes, when you need a product plan, or when the answer is a simple one-file fact lookup. In those cases, read the file directly or use an implementation-oriented workflow instead.

How does the skill handle complex questions spanning many files?▼

It opens bounded parallel exploration lanes, typically one for primary code paths, one for configuration and orchestration, and one for tests and docs. Each lane answers a concrete sub-question, and results are merged into a single ranked synthesis.