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.