login
rcantarelli11

agentlens

by @rcantarelli11 in Productivity
0
0
# Install this skill:
npx skills add rcantarelli11/shared-skills --skill "agentlens"

Install specific skill from multi-skill repository

# Description

Navigate and understand codebases using agentlens hierarchical documentation. Use when exploring new projects, finding modules, locating symbols in large files, finding TODOs/warnings, or understanding code structure.

# SKILL.md

name: agentlens
description: Navigate and understand codebases using agentlens hierarchical documentation. Use when exploring new projects, finding modules, locating symbols in large files, finding TODOs/warnings, or understanding code structure.
metadata:
short-description: Codebase navigation with agentlens
author: agentlens
version: "1.0"

AgentLens - Codebase Navigation

Before Working on Any Codebase

Always start by reading .agentlens/INDEX.md for the project map.

Level File Purpose
L0 INDEX.md Project overview, all modules listed
L1 modules/{slug}/MODULE.md Module details, file list
L1 modules/{slug}/outline.md Symbols in large files
L1 modules/{slug}/memory.md TODOs, warnings, business rules
L1 modules/{slug}/imports.md File dependencies
L2 files/{slug}.md Deep docs for complex files 
INDEX.md β†’ Find module β†’ MODULE.md β†’ outline.md/memory.md β†’ Source file

When To Read What

You Need Read This
Project overview .agentlens/INDEX.md
Find a module INDEX.md, search module name
Understand a module modules/{slug}/MODULE.md
Find function/class in large file modules/{slug}/outline.md
Find TODOs, warnings, rules modules/{slug}/memory.md
Understand file dependencies modules/{slug}/imports.md

Best Practices

  1. Don't read source files directly for large codebases - use outline.md first
  2. Check memory.md before modifying code to see warnings and TODOs
  3. Use outline.md to locate symbols, then read only the needed source sections
  4. Regenerate docs with agentlens command if they seem stale

For detailed navigation patterns, see references/navigation.md
For structure explanation, see references/structure.md

# Related Skills

moltbot
obsidian @moltbot

Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.

β˜… 65,001

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚑ Amp πŸš€ Antigravity πŸ€– Claude Code πŸ¦€ Clawdbot πŸ“ Codex ▢️ Cursor πŸ€– Droid πŸ’Ž Gemini CLI πŸ™ GitHub Copilot πŸͺΏ Goose πŸ“Š Kilo Code πŸ”§ Kiro CLI πŸ’» OpenCode 🦘 Roo Code 🌲 Trae πŸ„ Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.