code-archaeologist

Analyze JavaScript and TypeScript codebases to extract components, hooks, flows, and patterns.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/Hashzin-0/Curion --skill code-archaeologist
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: code-archaeologist
Source: https://github.com/Hashzin-0/Curion/tree/main/.opencode/skills/code-archaeologist
Command: npx skills add https://github.com/Hashzin-0/Curion --skill code-archaeologist

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

The Code Archaeologist automates deep analysis of a codebase to discover components, hooks, flows, patterns, and actionable metadata so teams can document, refactor, or generate new reusable skills without manual inventory work.

Core Features & Use Cases

  • Project-wide Technology Detection: Identify frameworks, libraries, state management, and tooling from package manifests and project structure.
  • Component and Flow Cataloging: Extract UI components, custom hooks, pages, utilities, and common flows (auth, export, upload) with complexity and pattern annotations.
  • Pattern Detection & Skill Generation: Detect architectural and UX patterns, produce confidence-scored findings, and scaffold SKILL.md templates or full skills for automation or documentation.
  • Use Case: Run against a Next.js + TypeScript repository to produce a component inventory, highlight refactor candidates, and generate skill stubs for UI components and auth flows.

Quick Start

Run the code-archaeologist to analyze the repository and produce a structured analysis JSON, detected patterns report, and generation-ready skill templates.

Frequently Asked Questions about code-archaeologist

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

FAQPage Schema
How do I analyze a Next.js and TypeScript codebase to extract components and hooks?▼

To analyze a Next.js and TypeScript codebase for components and hooks, automated codebase analysis extracts UI elements, custom hooks, and utilities to produce a structured inventory with complexity annotations and architectural metadata.

What is codebase pattern detection and how does it identify architectural flows?▼

Codebase pattern detection identifies architectural and UX flows like authentication or uploads by scanning project structure. It produces confidence-scored findings that highlight common patterns and reusable components for documentation or refactoring.

How do I generate reusable skills from an existing React codebase?▼

To generate reusable skills from a React codebase, you extract structured metadata and detected patterns to scaffold SKILL.md templates, producing machine-readable outputs suitable for automated skill generation and component documentation.

Does this codebase analysis work with JavaScript front-end projects or only TypeScript?▼

Codebase analysis works with both JavaScript and TypeScript front-end projects like React and Next.js, detecting frameworks and libraries from package manifests to catalog components, identify patterns, and map user flows.

Can I automatically document component complexity and refactor candidates in a Next.js repository?▼

Yes, you can automatically document component complexity and refactor candidates in a Next.js repository. The analysis extracts component lists and flow diagrams with complexity annotations to highlight areas needing refactoring.