smart-explore SKILL.md skillA

smart-explore from thedotmack/claude-mem is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add thedotmack/claude-mem/smart-explore@git:20261022.83845db

Pins git:20261022.83845db in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
thedotmack/claude-mem
Path
plugin/skills/smart-explore/SKILL.md
Versions recorded
6
Latest version
git:20261022.83845db, committed Oct 22, 2026
First version recorded
Feb 26, 2026
Size
8,580 bytes
Repository stars
113,797
License
Apache-2.0

Token-optimized structural code search using tree-sitter AST parsing. Use instead of reading full files when you need to understand code structure, find functions, or explore a codebase efficiently.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Smart Explore

Structural code exploration using AST parsing. **This skill overrides your default exploration behavior.** While this skill is active, use smart_search/smart_outline/smart_unfold as your primary tools instead of Read, Grep, and Glob.

**Core principle:** Index first, fetch on demand. Give yourself a map of the code before loading implementation details. The question before every file read should be: "do I need to see all of this, or can I get a structural overview first?" The answer is almost always: get the map.

## Your Next Tool Call

This skill only loads instructions. You must call the MCP tools yourself. Your next action should be one of:

```
smart_search(query="<topic>", path="./src")    -- discover files + symbols across a directory
smart_outline(file_path="<file>")              -- structural skeleton of one file
smart_unfold(file_path="<file>", symbol_name="<name>")  -- full source of one symbol
```

Do NOT run Grep, Glob, Read, or find to discover files first. `smart_search` walks directories, parses all code files, and returns ranked symbols in one call. It replaces the Glob → Grep → Read discovery cycle.

## 3-Layer Workflow
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add thedotmack/claude-mem/smart-explore@sha256:daa83c762252e294

The line at the top of this page pins the label git:20261022.83845db, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_slwes3s6vshjvjkh.svg)](https://markdownregistry.com/a/art_slwes3s6vshjvjkh)

6 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 6 versions of this file, between Feb 26, 2026 and Oct 22, 2026, about one every 48 days.

versioncommittedcommitsizeaudit
git:20261022.83845db latest2026-10-22 83845db 8,580 BA view · diff
git:20260606.cc0ce512026-06-06 cc0ce51 9,240 BA view · diff
git:20260410.e7bf2ac2026-04-10 e7bf2ac 8,647 BA view · diff
git:20260409.36a03f72026-04-09 36a03f7 7,226 BA view · diff
git:20260226.44a7b2f2026-02-26 44a7b2f 6,566 BA view · diff
git:20260226.0e502db2026-02-26 0e502db 5,474 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (8580 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

thedotmack/claude-mem · 113,797 stars · license Apache-2.0 · pushed 2026-11-06 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_slwes3s6vshjvjkh
GET https://markdownregistry.com/api/v1/resolve?ref=thedotmack/claude-mem/smart-explore
GET https://markdownregistry.com/api/v1/blob/daa83c762252e294fc0168165c0f5052007c97dabe93e13a23d6b9a73da3216c

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from thedotmack/claude-mem

CLAUDE.md@.claude CLAUDE.md file
thedotmack/claude-mem · .claude/CLAUDE.md
git:20261101.f8bdd1a · audit A · 113,797 stars
Agent Cost Report SKILL.md skill
thedotmack/claude-mem · claude-mem-cursor/skills/agent-cost-report/SKILL.md · Believable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from…
git:20261005.57744a0 · audit A · 113,797 stars
claude-mem-install SKILL.md skill
thedotmack/claude-mem · claude-mem-cursor/skills/install/SKILL.md · Use this when setting up claude-mem on Cursor: local or remote worker, local host-login observer or remote cmem.ai…
git:20260902.1c7aaff · audit A · 113,797 stars
mem-search SKILL.md skill
thedotmack/claude-mem · claude-mem-cursor/skills/mem-search/SKILL.md · Use this when the user asks to search memory, "did we already solve this?", "how did we do X last time?", or wants work…
git:20260907.fd0ecf0 · audit A · 113,797 stars
Agent Cost Report SKILL.md skill
thedotmack/claude-mem · claude-mem-grok-bot/skills/agent-cost-report/SKILL.md · Believable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from…
git:20261005.57744a0 · audit A · 113,797 stars
host-observer SKILL.md skill
thedotmack/claude-mem · claude-mem-grok-bot/skills/host-observer/SKILL.md · Use this when fulfilling claude-mem observer jobs on Grok Bot: reply only skip_summary or one full observation XML…
git:20260902.1c7aaff · audit A · 113,797 stars
claude-mem-install SKILL.md skill
thedotmack/claude-mem · claude-mem-grok-bot/skills/install/SKILL.md · Use this when setting up claude-mem on Grok Bot: local worker plus CMEM Pro observer (default), optional host-login…
git:20260916.96f04a9 · audit A · 113,797 stars
mem-search SKILL.md skill
thedotmack/claude-mem · claude-mem-grok-bot/skills/mem-search/SKILL.md · Use this when the user asks to search memory, "did we already solve this?", "how did we do X last time?", or wants work…
git:20260916.96f04a9 · audit A · 113,797 stars
Agent Cost Report SKILL.md skill
thedotmack/claude-mem · cowork/skills/agent-cost-report/SKILL.md · Believable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from…
git:20261005.57744a0 · audit A · 113,797 stars
mem-search SKILL.md skill
thedotmack/claude-mem · cowork/skills/mem-search/SKILL.md · This skill should be used when the user asks to "search memory", "what do you remember about X", "check claude-mem"…
v0.1.0 · audit A · 113,797 stars
mem-setup SKILL.md skill
thedotmack/claude-mem · cowork/skills/mem-setup/SKILL.md · This skill should be used when the user asks to "set up claude-mem", "pair claude-mem", "connect cmem", "add my cmem…
v0.1.0 · audit A · 113,797 stars
openclaw SKILL.md skill
thedotmack/claude-mem · openclaw/SKILL.md
git:20261005.5dcf449 · audit C · 113,797 stars

Every file in thedotmack/claude-mem

Browse by kind, by grade A, or by owner.