Explore an idea against the actual codebase without changing files.

MITAuto-check passed

Install Explore

skills CLI
$ npx skills add aiblueprinthq/ai-blueprint --skill explore -a claude-code

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

GitHub CLI
$ gh skill install aiblueprinthq/ai-blueprint 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/aiblueprinthq/ai-blueprint.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/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/

Facts

Skill name
explore
GitHub stars
461
Token cost
~1.1k tokens
SKILL.md length
600 words
Files
1
Skills in repo
20
Repo updated
First seen
Licence
MIT

At a glance

Explore an idea against the actual codebase without changing files.

  • Considering an idea
  • SKILL.md covers Start from the question, Discuss the options, Keep the boundaries clear and Neighbors and handoff
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Weighing options without writing a spec

What it does

Explore is an agent skill from aiblueprinthq/ai-blueprint. Explore an idea against the actual codebase without changing files. Investigate whether a change would help, compare alternatives and tradeoffs, and discuss uncertainty before deciding whether to plan anything. Use for /explore, considering an idea, or weighing options without writing a spec.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: A file-backed, spec-driven AI coding workflow framework for building real software while staying in control. The licence is MIT.

When your agent uses it

  • Considering an idea
  • Weighing options without writing a spec

Example prompts

  • “/explore”

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    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 75 tokens; SKILL.md has 600 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~75
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); files beside SKILL.md are not scanned.

SKILL.md

The full file from aiblueprinthq/ai-blueprint at commit 1a0b660, republished under its MIT licence (© aiblueprinthq). 600 words, ~1,100 tokens.

Download SKILL.mdSave it as .claude/skills/explore/SKILL.md (or your agent's skills folder).
name
explore
description
Explore an idea against the actual codebase without changing files. Investigate whether a change would help, compare alternatives and tradeoffs, and discuss uncertainty before deciding whether to plan anything. Use for /explore, considering an idea, or weighing options without writing a spec.

explore - investigate an idea before deciding to build

Context reuse: Reuse any required file already loaded in project instructions or the current session. Read it again only if absent, changed, or exact current bytes or line references are needed.

Explore is a read-only conversation grounded in the actual project. It can help with questions such as whether caching would help a dashboard, whether teams belong in the product, or which upload approach fits existing code.

No plans or active feature are required. Do not require /overview, invent a plan, or treat missing Blueprint context as a blocker to discussing the idea. This command never writes activity state, including blueprint/.state/run.json.

Start from the question

Use the supplied topic or relevant conversation context. With neither, ask what the user wants to investigate. For a vague idea, state a tentative interpretation and ask a focused question only when its answer changes the investigation.

Reuse context already loaded in the session. Read relevant project instructions, code, tests as text, manifests, and existing plans when they help answer the question. Follow the actual implementation far enough to support your claims; point to concrete files or symbols. Avoid scanning unrelated parts of the repo. Read-only Git inspection can establish what exists or is already in progress.

Authoritative documentation lookup is appropriate when technical uncertainty needs it. Distinguish documented facts from what this project actually uses. Missing code or evidence is an uncertainty to explain, not permission to execute an experiment or to invent current behavior.

Discuss the options

Keep the conversation proportional to the question. Compare plausible options against the user's needs and existing project constraints. Include doing nothing when the current behavior may already be sufficient. Do not invent scale, security requirements, or new abstractions to justify a change.

Explain the strongest case against your recommendation and how confident you are. Separate observed facts, assumptions, and unanswered questions. Say what evidence could change the recommendation without gathering it through execution. An unresolved question or a recommendation to leave the project alone is a valid outcome.

Use a small diagram in the response when it makes a relationship or tradeoff clearer. Do not create diagram files. There is no mandatory output template, report, question count, or next-step checklist. Follow the user's responses and let the discussion continue as long as useful.

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

Keep the boundaries clear

  • Never create, edit, or delete files, including specs, plans, notes, generated output, and activity state. Do not save the conversation into the project.
  • Never install dependencies, execute product code, run tests or builds, start servers, perform browser interactions, or call state-changing tools. Read source and existing evidence instead of testing a hypothesis by execution.
  • Never create or switch branches, commit, merge, push, publish, or deploy.
  • Never turn a request to discuss an idea into approval to plan or implement it. If the user asks for changes, explain the appropriate handoff and keep this Explore invocation read-only. Do not invoke another command automatically.

Neighbors and handoff

  • /brief explains an existing build-plan item, its scope, dependencies, and size. Explore can discuss an unplanned idea or question a planned approach.
  • /discovery develops broader product direction and reviewed planning drafts. Explore does not draft either planning file.
  • /debug reproduces and isolates an actual failure. Explore discusses options without executing code to diagnose or verify them.
  • /feature writes a buildable spec; /fix specifies a confirmed small change. Suggest the appropriate command only when the user is ready to proceed.

Do not force a handoff at the end of every response. Keep discussing the idea when that is what the user wants, and leave the project unchanged.

© aiblueprinthq, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/explore of aiblueprinthq/ai-blueprint.

Open the folder on GitHubat commit 1a0b660

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
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Explore this skillaiblueprinthq/ai-blueprint461—~1.1kAutomated safety check: PassMIT
Idea Darwinsickn33/agentic-awesome-skills47k2 repos~1.1kAutomated safety check: PassMIT
Idea Refinementaddyosmani/agent-skills103k6 repos~2kAutomated safety check: PassMIT
Make Changesremix-run/remix33k—~2.4kAutomated safety check: PassMIT
Code ChangesJanDeDobbeleer/oh-my-posh24k—~1.2kAutomated safety check: PassMIT
Orch Change Featureaffaan-m/ECC275k1 repos~420Automated safety check: PassMIT

Similar skills

  • Idea Darwin

    sickn33/agentic-awesome-skills

    Darwinian idea evolution engine — toss rough ideas onto an evolution island, let them compete, crossbreed, and mutate through structured rounds to surface your strongest concepts.

    47k GitHub starsUsed in 2 repos~1.1k tokens
    Auto-check passed
  • Idea Refinement

    addyosmani/agent-skills

    Guides a conversation that takes a vague idea through divergent and convergent thinking and ends in a markdown one-pager covering scope and assumptions.

    103k GitHub starsUsed in 6 repos~2k tokens
    Agent WorkflowsAuto-check passed
  • Make Changes

    remix-run/remix

    Create or update Remix repo change files under packages//.changes.

    33k GitHub stars~2.4k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Code Changes

    JanDeDobbeleer/oh-my-posh

    Orchestration workflow for any task that ends in code changes: issue analysis, pull request review, feature implementation, bug fixes, refactors, or fleshing out an idea.

    24k GitHub stars~1.2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Orchestrate altering an existing, working feature to new desired behavior — update its tests to the new spec, change the implementation to match, review, and gated commit.

    275k GitHub starsUsed in 1 repo~420 tokens
    Auto-check passed
  • Change Management

    sickn33/agentic-awesome-skills

    Implement change management processes. An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~3.5k tokens
    DevOps & CloudAuto-check passed

More from aiblueprinthq/ai-blueprint

All 20 skills in this repo
  • Adopt

    aiblueprinthq/ai-blueprint

    Adopt Blueprint into an existing brownfield codebase by surveying shipped behavior and generating plans, standards, commands, adapter choices, and visibility setup.

    461 GitHub stars~2.7k tokensUpdated 3 days ago
    Auto-check passed
  • CI

    aiblueprinthq/ai-blueprint

    Set up or normalize one project Verify command and matching GitHub Actions checks while preserving existing CI, with an optional local pre-push hook.

    461 GitHub stars~2.2k tokensUpdated 3 days ago
    Auto-check passed
  • Doctor

    aiblueprinthq/ai-blueprint

    Run a Blueprint health and context check covering setup, adapters, commands, visibility, plans, overview freshness, configuration, dashboard state, and workflow drift.

    461 GitHub stars~4.5k tokensUpdated 3 days ago
    Auto-check: notes
  • Feature

    aiblueprinthq/ai-blueprint

    Turn the next, named, or numbered build-plan feature into a buildable current-feature.md spec with small steps and done-when criteria.

    461 GitHub stars~2.8k tokensUpdated 3 days ago
    Auto-check passed
  • Onboard

    aiblueprinthq/ai-blueprint

    Onboard a fresh or early scaffold after Blueprint is overlaid by tuning commands, standards, adapters, visibility, and context loading.

    461 GitHub stars~4.5k tokensUpdated 3 days ago
    Auto-check passed
  • Overview

    aiblueprinthq/ai-blueprint

    Validate and normalize project-plan.md and build-plan.md, then generate the durable project-overview.md used by agents.

    461 GitHub stars~3.8k tokensUpdated 3 days ago
    Auto-check passed

Questions about Explore

What does Explore do?

Explore an idea against the actual codebase without changing files. Explore is an agent skill from aiblueprinthq/ai-blueprint. Explore an idea against the actual codebase without changing files.

When should I use Explore?

Explore fits situations like: considering an idea; weighing options without writing a spec.

How do I install Explore in Claude Code?

Run `npx skills add aiblueprinthq/ai-blueprint --skill explore -a claude-code`. Or copy the skill folder (.agents/skills/explore in aiblueprinthq/ai-blueprint) 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 aiblueprinthq/ai-blueprint --skill explore -a codex`. Or copy the skill folder (.agents/skills/explore in aiblueprinthq/ai-blueprint) 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 aiblueprinthq/ai-blueprint --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?

SKILL.md names no scripts, command-line tools or credentials: Explore is instructions for the agent only.

Does Explore access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. 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. Review the folder before installing.

What licence does Explore use?

Explore is published under the MIT 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: Idea Darwin (sickn33/agentic-awesome-skills, 47k stars), Idea Refinement (addyosmani/agent-skills, 103k stars), Make Changes (remix-run/remix, 33k stars) and Code Changes (JanDeDobbeleer/oh-my-posh, 24k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Explore?

aiblueprinthq (a GitHub organization) maintains it in aiblueprinthq/ai-blueprint, which has 461 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on October 5, 2026.

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