Agent skill

Explore

Explores codebase structure, stack, and architecture. An agent skill from softspark/ai-toolkit.

Apache-2.0Auto-check passedDevelopment

Install Explore

skills CLI

$ npx skills add softspark/ai-toolkit --skill explore -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install softspark/ai-toolkit explore --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/softspark/ai-toolkit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/app/skills/explore .claude/skills/explore && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "explore" agent skill from https://github.com/softspark/ai-toolkit/tree/main/app/skills/explore into .claude/skills/explore/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "explore", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/softspark/ai-toolkit/tree/main/app/skills/explore

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add softspark/ai-toolkit --skill explore -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install softspark/ai-toolkit explore --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/softspark/ai-toolkit.git skills-src && mkdir -p .agents/skills && cp -r skills-src/app/skills/explore .agents/skills/explore && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "explore" agent skill from https://github.com/softspark/ai-toolkit/tree/main/app/skills/explore into .agents/skills/explore/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "explore", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add softspark/ai-toolkit --skill explore -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install softspark/ai-toolkit explore --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/softspark/ai-toolkit.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/app/skills/explore .cursor/skills/explore && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "explore" agent skill from https://github.com/softspark/ai-toolkit/tree/main/app/skills/explore into .cursor/skills/explore/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "explore", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/softspark/ai-toolkit.git --path app/skills/explore

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add softspark/ai-toolkit --skill explore -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install softspark/ai-toolkit explore --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/softspark/ai-toolkit.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/app/skills/explore .gemini/skills/explore && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "explore" agent skill from https://github.com/softspark/ai-toolkit/tree/main/app/skills/explore into .gemini/skills/explore/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "explore", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install softspark/ai-toolkit explore

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add softspark/ai-toolkit --skill explore -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/softspark/ai-toolkit.git skills-src && mkdir -p .github/skills && cp -r skills-src/app/skills/explore .github/skills/explore && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "explore" agent skill from https://github.com/softspark/ai-toolkit/tree/main/app/skills/explore into .github/skills/explore/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "explore", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add softspark/ai-toolkit --skill explore -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install softspark/ai-toolkit explore --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/softspark/ai-toolkit.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/app/skills/explore .opencode/skills/explore && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "explore" agent skill from https://github.com/softspark/ai-toolkit/tree/main/app/skills/explore into .opencode/skills/explore/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "explore", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: explore
GitHub stars: 179
Token cost: ~1.1k tokens
SKILL.md length: 439 words
Files: 2 (incl. scripts)
Skills in repo: 112
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Explores codebase structure, stack, and architecture. An agent skill from softspark/ai-toolkit.

Works in 4 steps: Maps project structure → Identifies technology stack → Finds key files and patterns → …
Tasks that involve Codebase onboarding
SKILL.md covers Project context, Usage, What This Command Does and Output Format, plus 8 more sections
Runs Python scripts from its folder; calls python3 and git

What it does

Explore is an agent skill from softspark/ai-toolkit. Explores codebase structure, stack, and architecture. Triggers: explore codebase, project structure, stack overview, architecture map.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/visualize.py`).

It sits in Development, covering Codebase onboarding. The repository describes itself as: Professional-grade AI coding toolkit: 94 skills, 44 agents, multi-platform (Claude, Cursor, Windsurf, Copilot, Gemini, Cline, Roo Code, Aider, Augment, Antigravity, Codex CLI… The licence is Apache-2.0.

When your agent uses it

Tasks that involve Codebase onboarding

Example prompts

“Use the explore skill to explore codebase structure, stack, and architecture. An agent skill from softspark/ai-toolkit”
“/explore”

Requirements

Python 3
Node.js
Pre-approved tools (allowed-tools): Read, Grep, Glob

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

Maps project structure
Identifies technology stack
Finds key files and patterns
Reports architecture overview

What it can do on your machine

Read from SKILL.md and the folder at commit d64db2b. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
- Read
- Grep
- Glob
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
- python3
- git
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Explore loads about 1.1k tokens when it runs. Until then it costs about 36 tokens; SKILL.md has 439 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~36
When it runs · the whole SKILL.md, loaded when a task matches: ~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from softspark/ai-toolkit at commit d64db2b, republished under its Apache-2.0 licence (© softspark). 439 words, ~1,111 tokens.

Download SKILL.mdSave it as .claude/skills/explore/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: explore
description: Explores codebase structure, stack, and architecture. Triggers: explore codebase, project structure, stack overview, architecture map.
allowed-tools: Read, Grep, Glob
user-invocable: true
effort: medium
argument-hint: [path or question]

Codebase Exploration

$ARGUMENTS

Explore and understand a codebase structure.

Project context

Config files: !find . -maxdepth 2 -type f -name "*.json" -o -name "*.toml" -o -name "*.yaml" -o -name "*.yml" 2>/dev/null | head -20

Usage

/explore [path]

What This Command Does

Maps project structure
Identifies technology stack
Finds key files and patterns
Reports architecture overview

Output Format

markdown

## Codebase Analysis Report

### Project Type
- **Language**: [TypeScript/Python/PHP/etc.]
- **Framework**: [Next.js/FastAPI/Laravel/etc.]
- **Package Manager**: [npm/pnpm/pip/composer]

### Directory Structure

project/ ├── src/ # Source code ├── tests/ # Test files ├── config/ # Configuration └── ...


### Key Files
| File | Purpose |
|------|---------|
| `src/index.ts` | Entry point |
| `src/api/` | API routes |

### Dependencies
- **Runtime**: [list]
- **Dev**: [list]

### Patterns Detected
- [Pattern 1]
- [Pattern 2]

### Entry Points
- [Entry 1]
- [Entry 2]

Technology Detection

Marker	Technology
`package.json`	Node.js
`tsconfig.json`	TypeScript
`next.config.*`	Next.js
`nuxt.config.*`	Nuxt
`pyproject.toml`	Python
`composer.json`	PHP
`pubspec.yaml`	Flutter/Dart
`Cargo.toml`	Rust
`go.mod`	Go

When to Use

Starting work on unfamiliar codebase
Before planning major changes
Understanding dependencies
Finding specific code patterns

READ-ONLY

This skill ONLY reads and analyzes. It does NOT write or modify any files.

Visual Output

For an interactive HTML tree visualization of the codebase:

bash

python3 ${CLAUDE_SKILL_DIR}/scripts/visualize.py .

This generates codebase-map.html with collapsible directories, file sizes, and type-colored indicators.

KB Integration

python

smart_query("codebase analysis: {technology}")
hybrid_search_kb("project structure {framework}")

Rules

MUST use Glob and Grep before Read — scan for shape before opening files
MUST deliver a map of the codebase (entry points, layers, module boundaries), not a file listing — a tree without interpretation is noise
NEVER read every file sequentially; target reads via grep patterns and filename globs
NEVER modify any file — this is a read-only skill
CRITICAL: when the repo contains generated code (node_modules, vendor/, dist/, build/), exclude it from scans or the signal drowns in generated noise
MANDATORY: summarize the stack once at the top (language, framework, package manager, test runner) before diving into structure

Show full SKILL.md (196 more words)Show less

Gotchas

find . and ls -R ignore .gitignore by default and include node_modules, vendor/, .venv/, target/. Use git ls-files or fd / rg for a git-aware listing, or explicitly prune.
package.json says "type": "module" → ESM; absence → CommonJS. Mixing them without noticing produces "Cannot use import statement outside a module" errors later; call out the setting in the report.
Frameworks with file-based routing (Next.js, Nuxt, SvelteKit) treat the app/ or pages/ tree as the router. A directory listing alone does not reveal routes — the framework convention does. Name the framework first, then the routes.
pyproject.toml can declare multiple project layouts (src/, flat, namespace packages). "Where is the main code" is not obvious without reading [tool.setuptools.packages] or [tool.poetry.packages].
Large monorepos use workspaces (pnpm-workspace.yaml, nx.json, turbo.json) with apps and packages. Treating the root as the project conceals the actual component boundaries — surface the workspace topology first.

When NOT to Use

To explain a specific module's design — use /explain
To find a specific identifier or symbol — use Grep directly or /research-mastery
To audit architecture for deepening candidates — use /architecture-audit
To scaffold a new project — use /app-builder
When the user already knows the codebase — skip the overview and jump to the concrete task

Files

SKILL.md and 1 other file (scripts) in app/skills/explore of softspark/ai-toolkit.

SKILL.md
scripts/visualize.py

Open the folder on GitHubat commit d64db2b

Compare with similar skills

Explore next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Explore compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Explore this skillsoftspark/ai-toolkit	179	—	~1.1k	Automated safety check: Pass	Apache-2.0	yesterday
Codebase Knowledge Graph Q&AEgonex-AI/Understand-Anything	86k	1 repos	~1.2k	Automated safety check: Pass	MIT	2 days ago
Understand ExplainEgonex-AI/Understand-Anything	86k	1 repos	~1.3k	Automated safety check: Pass	MIT	2 days ago
Repomix Codebase Exploreryamadashy/repomix	29k	1 repos	~2.7k	Automated safety check: Pass	MIT	4 days ago
Code Graph Mermaid Diagramstrailofbits/skills	7.4k	1 repos	~1.7k	Automated safety check: Pass	CC-BY-SA-4.0	yesterday
Project Onboarding Guide from Knowledge GraphEgonex-AI/Understand-Anything	86k	—	~1.2k	Automated safety check: Pass	MIT	2 days ago

Similar skills

Codebase Knowledge Graph Q&A
Egonex-AI/Understand-Anything
Answers questions about a codebase by searching a prebuilt knowledge graph of its files, functions, classes and dependencies, not by rereading every source file.
86k GitHub starsUsed in 1 repo~1.2k tokens
DevelopmentAuto-check passed
Understand Explain
Egonex-AI/Understand-Anything
Gives an in-depth explanation of one file, function or module by reading the project's knowledge graph and checking that the graph is still fresh.
86k GitHub starsUsed in 1 repo~1.3k tokens
DevelopmentAuto-check passed
Repomix Codebase Explorer
yamadashy/repomix
Packs a local or remote repository into a single AI-friendly file with the Repomix CLI, then reads and searches that output to explain structure, find patterns or report metrics.
29k GitHub starsUsed in 1 repo~2.7k tokens
DevelopmentAuto-check passed
Code Graph Mermaid Diagrams
trailofbits/skills
Official
Generates Mermaid diagrams from Trailmark code graphs, including call graphs, class hierarchies, module dependency maps, complexity heatmaps and attack surface data flows.
7.4k GitHub starsUsed in 1 repo~1.7k tokens
DevelopmentAuto-check passed
Project Onboarding Guide from Knowledge Graph
Egonex-AI/Understand-Anything
Writes an onboarding guide for new team members from a project's existing knowledge graph, after checking that the graph still matches the current commit.
86k GitHub stars~1.2k tokensUpdated 2 days ago
DevelopmentAuto-check passed
GitDiagram Repository Overview
ahmedkhaleel2004/gitdiagram
Explains the architecture of a public GitHub repository through GitDiagram: how the code is organized, the main components with paths, and a Mermaid diagram.
18k GitHub stars~427 tokensUpdated today
DevelopmentAuto-check passed

Questions about Explore

What does Explore do?

Explores codebase structure, stack, and architecture. An agent skill from softspark/ai-toolkit. Explore is an agent skill from softspark/ai-toolkit. Explores codebase structure, stack, and architecture.

When should I use Explore?

Explore fits situations like: tasks that involve Codebase onboarding.

How do I install Explore in Claude Code?

Run `npx skills add softspark/ai-toolkit --skill explore -a claude-code`. Or copy the skill folder (app/skills/explore in softspark/ai-toolkit) into .claude/skills/explore in your project. Claude Code loads it when a task matches its description.

How do I install Explore in Codex?

Run `npx skills add softspark/ai-toolkit --skill explore -a codex`. Or copy the skill folder (app/skills/explore in softspark/ai-toolkit) into .agents/skills/explore in your project. Codex loads it when a task matches its description.

Can I use Explore in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add softspark/ai-toolkit --skill explore -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/explore, .gemini/skills/explore, .github/skills/explore and .opencode/skills/explore in your project.

What does Explore need to run?

Going by SKILL.md and its folder, Explore needs Python for the scripts in its folder and the command-line tools its instructions call (python3 and git). Our summary lists: Python 3; Node.js. Its frontmatter pre-approves these tools: Read, Grep, Glob.

Does Explore access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Explore safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Explore use?

Explore is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Explore use?

About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Explore?

Skills that share tags, products or a category with Explore: Codebase Knowledge Graph Q&A (Egonex-AI/Understand-Anything, 86k stars), Understand Explain (Egonex-AI/Understand-Anything, 86k stars), Repomix Codebase Explorer (yamadashy/repomix, 29k stars) and Code Graph Mermaid Diagrams (trailofbits/skills, 7.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Explore?

softspark (a GitHub user) maintains it in softspark/ai-toolkit, which has 179 GitHub stars. The repository holds 112 skills in this directory. The repository was last updated on October 7, 2026.

Source: softspark/ai-toolkit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Explore

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Codebase Exploration

Project context

Usage

What This Command Does

Output Format

Technology Detection

When to Use

READ-ONLY

Visual Output

KB Integration

Rules

Gotchas

When NOT to Use

Files

Compare with similar skills

Similar skills

More from softspark/ai-toolkit

Related

Questions about Explore