Skip to content
cccskills
FreePublished on GitHub

tracedocs

Turn a codebase into Markdown guides for operation, deployment, architecture, and maintenance, plus an index.json for AI agents. Operational claims include source references and confidence labels, while unverified deployment details remain documented gaps.

OriginalShow the original description

Turn any codebase into evidence-grounded Markdown docs plus a machine-readable index.json. Every claim cites its source; never invents deployment steps.

See how to install

Good for

  • Understand an unfamiliar codebase
  • Create source-backed operation and deployment guides
  • Prepare documentation and an index for an AI agent handoff
  • Build study materials traceable to source files

Files included (1)

  • SKILL.md1.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

tracedocs

Turn any codebase into an evidence-grounded documentation package (overview, operation, deployment, learning, architecture, API/data, troubleshooting, maintenance) plus a machine-readable index.json for AI agents. Every operational/deployment claim cites a source file and a confidence label (Verified / Inferred / Unknown / Needs confirmation); it never invents deployment steps and records gaps instead.

Full skill, references, templates, and a validated sample output: https://github.com/wxggzz/tracedocs (MIT).

When to Use This Skill

  • Onboarding to, or documenting, an unfamiliar codebase
  • Producing durable, in-repo docs for operation, deployment, and maintenance
  • Preparing an AI-agent-ready knowledge handoff (with index.json)
  • Turning a repo into a study guide whose claims are traceable to source

What This Skill Does

  1. Analyzes the codebase (stack, scripts, entry points, env-var names, deploy signals, tests).
  2. Builds an evidence map (source map, assumptions, generation log) with confidence labels.
  3. Writes the Markdown manuals and an index.json manifest; never invents deployment steps.
  4. Runs a quality check (paths exist, commands sourced, no secret values, gaps documented).

How to Use

Basic Usage

Use tracedocs to generate evidence-grounded study docs for this repository. Write the output to study-docs/.

Example

User: "Document ./my-app with tracedocs"

The skill scans the repo and writes a study-docs/ package (00-10 manuals + index.json + _evidence/), citing each operational claim's source and labelling its confidence - and explicitly noting anything it cannot verify (for example, "no deployment configuration found in the repo").

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Handle ActiveCampaign contact and marketing tasks through Rube MCP, a connection for agent tools. Find or create contacts, manage tags and subscriptions, enroll contacts in existing automated workflows, and create follow-up tasks.

  • Finding or registering contacts
  • Adding or removing contact tags
  • Subscribing contacts to lists or unsubscribing them
davepoon/buildwithclaude3.7KUpdated Oct 20, 2026

Research competitors’ live Meta and Google ads to identify opening hooks, offers, calls to action, and landing pages. Receive a sourced creative brief and up to three test ideas adapted to your product.

  • Find angles for new ad copy
  • Plan creative tests using competitor ads
  • Choose a landing page message
davepoon/buildwithclaude3.7KUpdated Oct 20, 2026

agent-analytics

FreeSummary

Add website or app tracking, then use command-line tools to review traffic, signups, drop-off, and returning users across projects. Run A/B tests, which compare alternative headlines or buttons, and inspect results to guide changes.

  • Adding page-view and key-action tracking
  • Reviewing traffic and referral sources across projects
  • Finding where visitors drop out before signup or purchase
davepoon/buildwithclaude3.7KUpdated Oct 20, 2026

Establish rules for when an AI agent should recall past context and save lasting decisions, corrections, preferences, and failures. Works with Markdown files or memory services, preserving decision history and surfacing conflicting records.

  • Carry project conventions into the next session
  • Save user corrections and lasting preferences
  • Record failed approaches and their causes
davepoon/buildwithclaude3.7KUpdated Oct 20, 2026

Audit local AI coding-agent sessions with agenttrace to identify spending, token use, tool failures, and operational problems. Produce readable or structured reports and define pass-or-fail thresholds for automated continuous integration checks.

  • Investigating session costs and token waste
  • Finding repeated tool failures and retries
  • Exporting session reports as Markdown or JSON
davepoon/buildwithclaude3.7KUpdated Oct 20, 2026

Audit saved agent sessions for access to private files and evidence that secret values entered an agent's context. Get findings without displaying secrets, identify keys needing rotation, and inspect Claude Code or Codex sessions in a local report.

  • Check whether an agent accessed .env files
  • Identify keys that may need rotation
  • Audit private-file access by subagents
davepoon/buildwithclaude3.7KUpdated Oct 20, 2026

See all skills by davepoon

Report a problem with this skill