crafter-map-project

Analyzes repository structure and generates .cftter/ context files.

2|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/richardriman/crafter --skill crafter-map-project
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: crafter-map-project
Source: https://github.com/richardriman/crafter/tree/main/skills/crafter-map-project
Command: npx skills add https://github.com/richardriman/crafter --skill crafter-map-project

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyze codebases and generate/update .crafter/ context files to keep Crafter projects synchronized with repository changes, reducing manual setup.

Core Features & Use Cases

  • Orchestrates the mapping workflow to translate repository structure into .crafter/ context files.
  • Delegates deep analysis to the Analyzer agent and surfaces results for user approval before writing any files.
  • Produces the required .crafter/ PROJECT.md, ARCHITECTURE.md, and STATE.md to track project state and changes.

Quick Start

Begin by running the crafter-map-project skill to analyze the repository and generate the necessary .crafter/ context files.

Frequently Asked Questions about crafter-map-project

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

FAQPage Schema
How do I generate context files for a codebase automatically?

To generate context files for a codebase, this skill analyzes the repository structure, manifests, and documentation, then produces PROJECT.md, ARCHITECTURE.md, and STATE.md files. It validates outputs against rules and presents results for user approval before writing anything to the .crafter/ directory.

What is the best way to map a repository structure into Crafter contexts?

Mapping a repository structure into Crafter contexts is done by orchestrating an analysis workflow that translates directory layouts and manifests into .crafter/ context files. It delegates deep analysis to identify project state and architecture, surfacing results for approval before writing.

How does codebase analysis keep Crafter projects synchronized with repository changes?

Codebase analysis keeps Crafter projects synchronized by identifying repository updates and generating updated .crafter/ context files. It analyzes directory layouts and documentation to produce PROJECT.md, ARCHITECTURE.md, and STATE.md, reducing manual setup and tracking project state.

Do I need to approve generated context files before they are written to my project?

Yes, user approval is required before writing any context files to your project. The skill validates the generated PROJECT.md, ARCHITECTURE.md, and STATE.md outputs against rules and presents the results for explicit approval to ensure safe synchronization.

Can I use this to analyze documentation and manifests for existing software projects?

Yes, you can analyze existing software projects by examining their directory layouts, manifests, and documentation. The skill processes these inputs to map the repository structure and generate the required .crafter/ context files for tracking project state.

What files are produced when mapping a codebase into Crafter contexts?

Mapping a codebase into Crafter contexts produces three specific files: PROJECT.md, ARCHITECTURE.md, and STATE.md. These files are generated inside the .crafter/ directory to track project state, architecture, and changes.