1. Habit
  2. Skills
  3. Index Knowledge skill
tursodatabase · 1K installs

Index Knowledge skill
Runs by itself, weekly docs refresh.

Agent docs match the codebase.

Install the Index Knowledge skill and make it a habit: follow https://gethabit.dev/skills/tursodatabase/index-knowledge.md

  1. 1Copy
  2. 2Paste into Claude Code, Codex or Cursor
  3. 3It runs by itself

1K installs25K starsMIT licenceSource on GitHub ↗

Index Knowledge

by tursodatabase · 1K installs

The skill

The index knowledge skill generates a hierarchy of AGENTS.md files for a codebase: a root file plus files for complex subdirectories, picked by a scoring matrix and written by parallel agents.

Only when you ask.

The habit

Agent docs match the codebase.

↻ Runs by itselfweekly docs refresh

How the habit works.
You don't have to.

Three questionsWhen does it start? How does it check its work? What does it remember?

01

It starts by itself

weekly docs refresh. Runs in Claude Code routine.

  • ↻ weekly docs refresh
  • 0 6 * * 1

02

It checks its work

size and dedupe checks. If a check fails, it tries again.

  • ✓root AGENTS.md exists
  • ✓root AGENTS.md is 50 to 150 lines
  • ✓each subdirectory AGENTS.md is 30 to 80 lines
  • ✓no child AGENTS.md repeats its parent

03

It remembers

AGENTS.md commit history. The next run reads it first: existing AGENTS.md files and their key insights.

AGENTS.md

One run, step by step.
Then it stops.

Stop ruleStops after one pass over the repository, with max depth from --max-depth.

  1. 01

    Plan the phases

    Your agent tracks discovery, scoring, generation and review with TodoWrite.

  2. 02

    Discover in parallel

    It launches explore agents scaled to project size and reads existing AGENTS.md and CLAUDE.md files.

  3. 03

    Map the code

    It measures structure with find and uses LSP symbols when available.

  4. 04

    Score directories

    It weights file count, subdirs, exports and references to pick AGENTS.md locations.

  5. 05

    Generate files

    It writes the root file first, then subdirectory files in parallel.

  6. 06

    Review and trim

    It removes generic advice and parent duplicates and prints the final report.

What it may do.
Nothing more.

Safe by defaultIt writes only in its own folder and asks you before anything goes out.

Is it for you?
Use it when it fits.

Quick checkRead both lists. If the left one sounds like you, the Index Knowledge skill helps.

Use it when

  • ✓ a repo has no AGENTS.md yet
  • ✓ AGENTS.md files are stale
  • ✓ onboarding agents to a large codebase

Skip it when

  • – the project has only a few files
  • – you want hand-written docs only

Questions

Index Knowledge skill, answered.

Does it delete my existing files?

Only with --create-new, and it reads them first to keep their context. The default mode updates them.

Does every folder get an AGENTS.md?

No. Low-scoring folders are skipped because the parent file covers them.

How do I install the Index Knowledge skill?

Copy the prompt at the top into your agent. It installs the skill from tursodatabase/turso and sets up the habit. Or run npx skills add tursodatabase/turso --skill index-knowledge.

Is the Index Knowledge skill free?

Yes. It is published under MIT. Habit is free too.

Index Knowledge. Now as a habit.

Install the Index Knowledge skill and make it a habit: follow https://gethabit.dev/skills/tursodatabase/index-knowledge.md

  • Free
  • No account
  • Undo in one line

All tursodatabase skills →More docs skills →

Works in

  • Claude Code
  • Codex
  • Cursor
  • ChatGPT
  • Claude app

Made by tursodatabase, published under MIT. Habit links to the original and never changes it. Is this your skill?

Copying didn't work here. Select the line and copy it by hand.