Code Archaeology Skill

Scan Gmail labels for code attachments and organize them into a local archive.

1|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/hilash/codearchaeology.ai --skill code-archaeology-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Code Archaeology Skill
Source: https://github.com/hilash/codearchaeology.ai/tree/main
Command: npx skills add https://github.com/hilash/codearchaeology.ai --skill code-archaeology-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Surface and organize Gmail code attachments into a local, browsable archive for easy exploration and reuse.

Core Features & Use Cases

  • Scan Gmail for code attachments and organize them by date/thread into a local catalog.
  • Browse results via a retro Gmail-style UI with AI-generated summaries.
  • Optional AI enrichment and PII scrubbing to improve privacy and data quality.

Quick Start

Clone the Code Archaeology repo, run the scanner to fetch Gmail attachments, and start the local web UI.

Frequently Asked Questions about Code Archaeology Skill

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

FAQPage Schema
How do I extract and organize code attachments from Gmail?

Extracting Gmail code attachments involves scanning your labels to group files by date and thread into a local, browsable catalog. You need OAuth credentials for Gmail API access and a local Python environment to run the scanner and UI.

Can I browse my Gmail code archive offline?

You can browse Gmail code attachments offline using a retro Gmail-style local web UI. The scanner fetches and organizes files directly to your machine, allowing you to explore the cataloged code without an active internet connection.

Do I need an OpenAI API key to scan Gmail attachments?

An OpenAI API key is optional, required only for AI-generated summaries and enrichment. The core functionality of scanning Gmail code attachments and building a local offline archive works without it.

What is the best way to generate summaries for archived code files?

Generating summaries for archived code files is best achieved using the optional OpenAI API enrichment feature. This processes your local Gmail attachment catalog to produce AI-generated summaries viewable in the local web UI.

How does PII scrubbing work with Gmail code attachments?

PII scrubbing functions as an optional AI enrichment step to improve privacy and data quality when archiving Gmail code attachments. It processes extracted files locally to help remove sensitive personal information before browsing.