Skip to content
cccskills
FreePublished on GitHub

ls-agentlens-codebase-navigation

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.

The English summary is being prepared. Showing the original description.

See how to install

Files included (3)

  • SKILL.md3.9 KB
  • references/navigation.md2.9 KB
  • references/structure.md2.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

AgentLens - Codebase Navigation

Before Working on Any Codebase

Always start by reading .agentlens/INDEX.md for the project map. If the target repo has no .agentlens/ directory, this skill is advisory only; fall back to normal repository discovery.

Generation Requirement

This skill consumes AgentLens documentation but does not generate it. LocalSetup does not include an agentlens CLI, script, or wrapper for regenerating .agentlens/ output.

  • If the target repo already documents an AgentLens generation command, run that project-provided command from the target repo root.
  • If an external agentlens command is installed in the environment, use the command and flags documented by that external tool.
  • If no generator is available, treat .agentlens/ as read-only navigation context and verify stale-looking claims against source files.

Do not assume agentlens is available from this repository or from PATH.

Navigation Hierarchy

LevelFilePurpose
L0INDEX.mdProject overview and module routing
L1modules/{slug}/MODULE.mdModule details, file list
L1modules/{slug}/outline.mdSymbols in large files, when generated
L1modules/{slug}/memory.mdWarnings and TODOs, when generated
L1modules/{slug}/imports.mdFile dependencies, when generated
L2files/{slug}.mdDeep docs for complex files, when generated

This is the public output hierarchy documented by the current upstream AgentLens README. Do not infer additional filenames from older package guidance.

Navigation Flow

INDEX.md -> Find module -> MODULE.md -> available sidecars -> Source file

When To Read What

You NeedRead This
Project overview.agentlens/INDEX.md
Find a moduleINDEX.md, search module name
Understand a modulemodules/{slug}/MODULE.md
Find function/class in large filemodules/{slug}/outline.md if present; otherwise search source
Find TODOs and warningsmodules/{slug}/memory.md if present; otherwise search source markers
Understand file dependenciesmodules/{slug}/imports.md if present; otherwise inspect source imports

Best Practices

  1. Start with the generated map for large codebases, then use outline.md when present to target source reads
  2. Check memory.md when present before modifying code; otherwise search source markers for warnings and TODOs
  3. Use outline.md when present to locate symbols; otherwise search source, then read only the needed sections
  4. Verify generated claims against source before editing; source remains authoritative when documentation is absent or stale
  5. Regenerate only through a documented command supplied by the target repo or an external AgentLens installation

Sidecars and Provenance

An optional _meta.json sidecar may appear beside imported skill content in some framework workflows. For ls-agentlens-codebase-navigation, that file is provenance only: it is not read by this skill, not required for activation, and not a substitute for the frontmatter above. If present, preserve it during source review unless a packaging or release audit explicitly classifies it as generated/private state.

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

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

Guide accessibility reviews for UI, documents, and workflows. Use for WCAG-oriented audits, keyboard review, semantics, contrast, and remediation planning.

The English summary is being prepared. Showing the original description.

CruxExperts/LocalSetup6Updated Oct 21, 2026

Use when choosing a LocalSetup Agent-* lane for exploration, research, bounded implementation, or review. Consult the static capability matrix; do not probe account or network availability.

The English summary is being prepared. Showing the original description.

CruxExperts/LocalSetup6Updated Oct 21, 2026

Guide agent email inbox workflows with prompt-injection defenses. Use for inbound email processing, webhooks, routing, and safety review.

The English summary is being prepared. Showing the original description.

CruxExperts/LocalSetup6Updated Oct 21, 2026

Use for Agent Q signed encrypted file-drop or mail ship and ingest, private registry v2 setup, queue status, and transport maintenance.

The English summary is being prepared. Showing the original description.

CruxExperts/LocalSetup6Updated Oct 21, 2026

Inventory wrapper for the alirezarezvani Claude skills bundle. Use when triaging its broad skill catalog and large script surface before any targeted import.

The English summary is being prepared. Showing the original description.

CruxExperts/LocalSetup6Updated Oct 21, 2026

Infrastructure automation with Ansible. Use for server provisioning, configuration management, application deployment, and multi-host orchestration. Includes example playbooks for VPS setup, security hardening, and common server configurations. Bundled examples may reference one platform; adapt paths and commands for your environment.

The English summary is being prepared. Showing the original description.

CruxExperts/LocalSetup6Updated Oct 21, 2026

See all skills by CruxExperts

Report a problem with this skill