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.