pyrs-ingest

Generate code pyramids from existing codebases using Python.

2|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/zachbutton/pyrs --skill pyrs-ingest
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pyrs-ingest
Source: https://github.com/zachbutton/pyrs/tree/main/skills/pyrs-ingest
Command: npx skills add https://github.com/zachbutton/pyrs --skill pyrs-ingest

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyrs-foundation, python, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the generation of code pyramids from existing codebases, ensuring that AI coding agents have persistent context and architectural alignment.

Core Features & Use Cases

  • Code Pyramid Generation: Automatically create code pyramids from existing code, capturing the intent and architecture.
  • Existing Code Integration: Re-ingest existing code into pyramids for legacy projects or when code evolves.
  • Use Case: Use this Skill to automatically generate a pyramid for a large codebase, capturing the overall architecture and functionality.

Quick Start

Run the pyrs-ingest skill with the ::ingest command to generate pyramids from your existing codebase.

Frequently Asked Questions about pyrs-ingest

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

FAQPage Schema
How do I generate a code pyramid from an existing Python codebase?

To generate a code pyramid from an existing Python codebase, run the ingest command to automatically analyze your code and capture the overall architecture and intent. This ensures persistent context for AI coding agents.

What is a code pyramid and how does it help with AI coding?

A code pyramid captures the intent and architecture of an existing codebase, providing persistent context and ensuring architectural alignment for AI coding agents during contextual coding and modifications.

Can I re-ingest code to update the architectural context for a legacy project?

Yes, you can re-ingest existing code into pyramids to update architectural context for legacy projects or evolving codebases. This ensures AI coding agents maintain accurate alignment as code changes over time.

Do I need pyrs-foundation to use the code pyramid generation scripts?

Yes, pyrs-foundation is a required dependency along with Python and various code analysis libraries. You must install these prerequisites before running the ingest command to generate code pyramids.

What's the best way to ensure architectural alignment when adding AI agents to legacy code?

Using automated code pyramid generation ensures architectural alignment by capturing the existing codebase's intent and architecture. This provides AI coding agents with persistent context, preventing misaligned modifications.