skills.rest
pulak999
pulak999COMMUNITY
Explore all skills by this author →
GitHub

ai-ledger

Audits AI-written code and maintains a searchable AI_LEDGER.md documentation file.

Updated Mar 21, 2026
Search Tags:#documentation#markdown#code navigation#code audit#session logging#ai-generated code
One-click install
npx skills add https://github.com/pulak999/ai-tooling --skill ai-ledger-pulak999
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ai-ledger
Source: https://github.com/pulak999/ai-tooling/tree/main/ai-assistant-kit/cursor-skills/ai-ledger
Command: npx skills add https://github.com/pulak999/ai-tooling --skill ai-ledger-pulak999

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When AI writes large amounts of code, users quickly lose track of what was built, why decisions were made, and where things live. This Skill audits AI-generated code and maintains a living AI_LEDGER.md file so the codebase stays understandable without the user having written it themselves. ## Core Features & Use Cases - Code Auditing: Reads specified files or entire directories and documents every function, data structure, data flow, design decision, and gotcha. - Living Ledger: Writes and incrementally updates AI_LEDGER.md with a flat searchable index of functions and types plus per-session historical entries. - Merge-Aware Updates: Preserves previous session entries, updates changed index rows, and marks removed items as [removed]. - Use Case: After a long AI coding session, ask for an audit of the repo and receive an updated AI_LEDGER.md with a plain-English overview, a function index, and notes on fragile spots before you modify anything. ## Quick Start Ask the AI to run the ai-ledger skill and audit everything in the repository to update AI_LEDGER.md.

Frequently Asked Questions about ai-ledger

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

FAQPage Schema
How do I document code that AI wrote for me?▼

Run the ai-ledger skill and specify files, a directory, or the whole repo to audit. It reads the code in full and writes an AI_LEDGER.md file containing a searchable function index and a plain-English session summary.

What is AI_LEDGER.md and what does it contain?▼

AI_LEDGER.md is a living document with two parts: a flat searchable index of every function, class, and type with file locations, and dated session entries describing overviews, design decisions, and gotchas.

Does running the audit again overwrite my previous ledger entries?▼

No. The skill reads the existing AI_LEDGER.md first and merges new content, preserving all previous session entries, updating changed index rows, and marking removed items as [removed].

Can I audit only part of my codebase instead of everything?▼

Yes. When the skill asks what to audit, you can provide specific files, a single directory, or say everything. It skips lockfiles, build artifacts, .env files, and binary assets automatically.

When should I run an AI code audit?▼

Run it at the end of any AI coding session, when you do not understand pasted code, or before modifying unfamiliar code. The ledger records what was produced and flags fragile or surprising behavior.

Related Skills

Explore More Software Engineering Skills→
LvcidPsycheLvcidPsyche
7

test-gen

Generate unit tests for functions, classes, and modules from source code.

Community
Intermediate
JubaKitiashviliJubaKitiashvili
41

erne-plan

Plan feature architecture for RN/Expo apps with file structure and task lists.

Community
Advanced
dorriodorrio

ln-401-task-executor

Execute a single implementation task with test-driven development and status updates.

Community
Intermediate
armanzeroeightarmanzeroeight
29

api-docs-generator

Generate API documentation from code into HTML or JSON formats.

Community
Intermediate