Project-Xray

What Project-Xray does

The system has a router skill, project-mentor, which tracks what is known and decides the next step; project-quick-scan, which judges whether a project is worth deeper study; and project-deep-analysis, which does the investigation, reverse engineering and modeling. Inputs can be a GitHub repository, a website or an application. Findings are sorted into facts, hypotheses, contradictions, unknowns, open questions and decisions, and each claim is tied to evidence with a strength rating and a confidence level.

Analysis depth runs across six levels, from orientation through usage, runtime, implementation and engineering to agent context, and the user's intent, such as use, deploy, modify or fork, selects which levels apply. Output comes in three layers: a guided explanation in chat, a PROJECT_KNOWLEDGE.md file for people, and an AGENTS.md or PROJECT_CONTEXT.md file that helps a coding agent change the project safely. State is persisted in STATE.yaml and EVIDENCE.yaml and updated incrementally. The README is written in Chinese.

Key features

• Three skills: project-mentor, project-quick-scan and project-deep-analysis
• Knowledge state split into facts, hypotheses, contradictions, unknowns, open questions and decisions
• Evidence strength and claim confidence recorded for each conclusion
• Six analysis depth levels chosen by user intent
• Persistent STATE.yaml and EVIDENCE.yaml files updated incrementally
• Outputs a human knowledge file and an AGENTS.md for coding agents

When to use it

• Deciding quickly whether an unfamiliar GitHub project is worth studying
• Working out how to deploy or modify a project you did not write
• Producing an AGENTS.md so a coding agent can edit the project safely

Who it is for: Vibe coders with limited programming background who use Hermes Agent to understand and adapt other people's projects.

How it fits with Hermes Agent

All three components are Hermes skills, tagged hermes-skill, and the README frames the output as context for coding agents such as Claude Code, Codex and Cursor.

FAQ