Hypothesis Generation
spacering-net/codeg
Structured hypothesis formulation from observations. An agent skill from spacering-net/codeg.
Routing guide -- when to use nansen agent (AI research) vs direct CLI data commands.
Install Nansen Agent Guide
$ npx skills add nansen-ai/nansen-cli --skill nansen-agent-guide -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install nansen-ai/nansen-cli nansen-agent-guide --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/nansen-ai/nansen-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/nansen-agent-guide .claude/skills/nansen-agent-guide && rm -rf skills-srcUse ~/.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/
Install the "nansen-agent-guide" agent skill from https://github.com/nansen-ai/nansen-cli/tree/main/skills/nansen-agent-guide into .claude/skills/nansen-agent-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nansen-agent-guide", 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 install https://github.com/nansen-ai/nansen-cli/tree/main/skills/nansen-agent-guideType 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.
$ npx skills add nansen-ai/nansen-cli --skill nansen-agent-guide -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install nansen-ai/nansen-cli nansen-agent-guide --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/nansen-ai/nansen-cli.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/nansen-agent-guide .agents/skills/nansen-agent-guide && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "nansen-agent-guide" agent skill from https://github.com/nansen-ai/nansen-cli/tree/main/skills/nansen-agent-guide into .agents/skills/nansen-agent-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nansen-agent-guide", 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.
$ npx skills add nansen-ai/nansen-cli --skill nansen-agent-guide -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install nansen-ai/nansen-cli nansen-agent-guide --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/nansen-ai/nansen-cli.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/nansen-agent-guide .cursor/skills/nansen-agent-guide && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "nansen-agent-guide" agent skill from https://github.com/nansen-ai/nansen-cli/tree/main/skills/nansen-agent-guide into .cursor/skills/nansen-agent-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nansen-agent-guide", 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 https://github.com/nansen-ai/nansen-cli.git --path skills/nansen-agent-guide--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add nansen-ai/nansen-cli --skill nansen-agent-guide -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install nansen-ai/nansen-cli nansen-agent-guide --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/nansen-ai/nansen-cli.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/nansen-agent-guide .gemini/skills/nansen-agent-guide && rm -rf skills-srcUse ~/.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/
Install the "nansen-agent-guide" agent skill from https://github.com/nansen-ai/nansen-cli/tree/main/skills/nansen-agent-guide into .gemini/skills/nansen-agent-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nansen-agent-guide", 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.
$ gh skill install nansen-ai/nansen-cli nansen-agent-guideInstalls 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).
$ npx skills add nansen-ai/nansen-cli --skill nansen-agent-guide -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/nansen-ai/nansen-cli.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/nansen-agent-guide .github/skills/nansen-agent-guide && rm -rf skills-srcUse ~/.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/
Install the "nansen-agent-guide" agent skill from https://github.com/nansen-ai/nansen-cli/tree/main/skills/nansen-agent-guide into .github/skills/nansen-agent-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nansen-agent-guide", 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.
$ npx skills add nansen-ai/nansen-cli --skill nansen-agent-guide -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install nansen-ai/nansen-cli nansen-agent-guide --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/nansen-ai/nansen-cli.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/nansen-agent-guide .opencode/skills/nansen-agent-guide && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "nansen-agent-guide" agent skill from https://github.com/nansen-ai/nansen-cli/tree/main/skills/nansen-agent-guide into .opencode/skills/nansen-agent-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nansen-agent-guide", 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
nansen-agent-guide- GitHub stars
- 139
- Token cost
- ~948 tokens
- SKILL.md length
- 383 words
- Files
- 1
- Skills in repo
- 32
- Repo updated
- First seen
- Licence
- MIT
At a glance
Routing guide -- when to use nansen agent (AI research) vs direct CLI data commands.
- Deciding how to answer a users research question with Nansen tools
- SKILL.md covers Authentication, Use nansen agent when, Use direct CLI commands when and Anti-patterns, plus 1 more section
- Needs NANSEN_API_KEY
- Tasks that involve Hypothesis generation
What it does
Nansen Agent Guide is an agent skill from nansen-ai/nansen-cli. Routing guide -- when to use nansen agent (AI research) vs direct CLI data commands. Use when deciding how to answer a user's research question with Nansen tools.
Its SKILL.md is about 950 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Research & Science, covering Hypothesis generation. The licence is MIT.
When your agent uses it
- Deciding how to answer a users research question with Nansen tools
- Tasks that involve Hypothesis generation
Example prompts
- “/nansen-agent-guide”
Requirements
- A credential in NANSEN_API_KEY
- Pre-approved tools (allowed-tools): Bash(nansen:*)
What it can do on your machine
Read from SKILL.md and the folder at commit d52e13d. 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:
Bash(nansen:*)
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).
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 these keys or tokens, usually read from environment variables:
NANSEN_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Nansen Agent Guide loads about 948 tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 383 words of instructions outside code blocks.
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 nansen-ai/nansen-cli at commit d52e13d, republished under its MIT licence (© nansen-ai). 383 words, ~948 tokens.
Download SKILL.mdSave it as
.claude/skills/nansen-agent-guide/SKILL.md (or your agent's skills folder).- name
- nansen-agent-guide
- description
- Routing guide -- when to use `nansen agent` (AI research) vs direct CLI data commands. Use when deciding how to answer a user's research question with Nansen tools.
- allowed-tools
- Bash(nansen:*)
Authentication
Nansen account API calls accept a selected nansen:api browser session or conventional API key with the same permissions. NANSEN_API_KEY takes precedence; optional primaryEnv preserves configured-key injection. Run nansen auth status for offline selection. Cached access expiry alone permits automatic renewal during an authorized task. Stop on anonymous selection, invalid state, blocked/uncertain renewal or actual auth failure; never drop a credential or fall back to anonymous x402 payment. Browser login does not grant wallet signing, privileged service identity or a persistent MCP integration key. Preserve all confirmation, signing, sanctions and geographic checks below. Browser login is available in CLI 2.0.0 within the macOS arm64 preview scope.
Agent vs CLI Routing
Public agent fast/expert and direct API commands accept the selected nansen:api browser session or conventional API key under the same account permissions.
| Need a... | Use |
|---|---|
| take (analysis, interpretation) | nansen agent |
| table (raw data, specific metrics) | Direct CLI commands |
| report (both) | Agent for narrative + CLI for data |
Use nansen agent when
- Question requires interpretation or synthesis across multiple data sources
- Open-ended research: "analyse this wallet", "what's happening with ETH smart money?"
nansen agent "What are top smart money tokens on Solana today and why?"
nansen agent "Analyse wallet 0x123... -- is this a smart trader?"
nansen agent "..." --expert # deeper analysis, 750 creditsCost: 200 credits (fast) / 750 credits (expert)
Use direct CLI commands when
- You need specific structured data -- prices, volumes, holders, flows
- Deterministic question: "top 10 tokens by netflow on ethereum"
- Piping output or building a data table
nansen research token screener --chain ethereum --smart-money --limit 10
nansen research smart-money netflow --chain solana
nansen research profiler balance --address 0x123... --chain ethereumCost: 5-50 credits per call
Show full SKILL.md (161 more words)Show less
Anti-patterns
- Don't use
nansen agentfor simple data fetches -- 40x more expensive - Don't use raw CLI for open-ended analysis -- returns data, not interpretation
- Don't chain 3+ agent calls -- get raw data via CLI, call agent once for synthesis
Browser session scope
Plain nansen login requests fresh browser approval; --no-browser prints the link/code for approval on another device and keeps the same native-storage requirements. NANSEN_API_KEY overrides the single saved credential. Use nansen auth status for offline cached/unverified selection details and nansen account for a free live check. Explicit login --human or login --api-key retains legacy key setup. Selected browser sessions renew automatically; uncertain renewal requires fresh login without replay or fallback to another account/payment.
Browser nansen:api grants have API-key-equivalent account permissions, subject to enabled admission and the same endpoint restrictions. Internal service identity and wallet signing are not granted. Browser sessions cannot authorize wallet signing or be exported as MCP keys. CLI 2.0.0 is published; the preview platform limits above still apply.
© nansen-ai, 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 skills/nansen-agent-guide of nansen-ai/nansen-cli.
Open the folder on GitHubat commit d52e13d
Compare with similar skills
Nansen Agent Guide 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Nansen Agent Guide this skillnansen-ai/nansen-cli | 139 | — | ~948 | Automated safety check: Pass | MIT | |
| Hypothesis Generationspacering-net/codeg | 3.9k | 14 repos | ~3.6k | Automated safety check: Notes | MIT | |
| Nature Paper CardYuan1z0825/nature-skills | 47k | 2 repos | ~2.1k | Automated safety check: Pass | Apache-2.0 | |
| Hypothesis GenerationK-Dense-AI/claude-scientific-writer | 2.4k | 2 repos | ~3.9k | Automated safety check: Pass | MIT | |
| Good QuestionRimagination/good-question | 305 | 1 repos | ~4.3k | Automated safety check: Pass | MIT | |
| High Stakes Analytics Decision Lablimingrui679-design/high-stakes-analytics-decision-lab | 1k | — | ~2.2k | Automated safety check: Pass | MIT |
Similar skills
Nature Paper Card
Yuan1z0825/nature-skills
Builds a structured deep-reading card for one scientific paper, covering methods, how experiments support claims, limitations and research ideas, with a script to prepare the source.
Hypothesis Generation
K-Dense-AI/claude-scientific-writer
Formulate evidence-bounded scientific questions, candidate hypotheses, rival explanations, causal or associational claims, discriminating predictions, measurements, and preregistration-ready…
Good Question
Rimagination/good-question
A skill your agent uses when a researcher is choosing, framing, refining, or stress-testing a research question, hypothesis, thesis topic, project idea, grant direction, paper angle, or stalled…
High Stakes Analytics Decision Lab
limingrui679-design/high-stakes-analytics-decision-lab
Build or review source-backed descriptive, diagnostic, predictive, and prescriptive analysis for consequential decisions.
Claim-Driven Experiment Planner
zjYao36/Auto-Research-Refine
Turns a refined research proposal into a claim-to-evidence-to-run-order roadmap instead of a sprawling benchmark wishlist.
More from nansen-ai/nansen-cli
All 32 skills in this repoNansen Smart Money Tracker
nansen-ai/nansen-cli
Smart money tracking — netflow, trades, holdings, perp trades.
Nansen Token Research
nansen-ai/nansen-cli
Token deep dive — info, OHLCV, holders, flows, flow intelligence, who bought/sold, DEX trades, PnL, perp trades, perp positions, perp PnL leaderboard.
Nansen Wallet Profiler
nansen-ai/nansen-cli
Wallet profiler — balance, PnL, labels, transactions, counterparties, related wallets, batch, trace, compare.
Nansen Limit Orders
nansen-ai/nansen-cli
Guide users through native limit orders on Solana via nansen trade limit-order create|list|cancel|update, and the alert-based settlement-signal fallback for chains without native support.
Nansen Smart Alerts
nansen-ai/nansen-cli
Manage smart alerts — list, create, update, toggle, delete. An agent skill from nansen-ai/nansen-cli.
Nansen General Search
nansen-ai/nansen-cli
Search for tokens or entities by name. An agent skill from nansen-ai/nansen-cli.
Related
Categories
Questions about Nansen Agent Guide
What does Nansen Agent Guide do?
Routing guide -- when to use nansen agent (AI research) vs direct CLI data commands. Nansen Agent Guide is an agent skill from nansen-ai/nansen-cli. Routing guide -- when to use nansen agent (AI research) vs direct CLI data commands.
When should I use Nansen Agent Guide?
Nansen Agent Guide fits situations like: deciding how to answer a users research question with Nansen tools; tasks that involve Hypothesis generation.
How do I install Nansen Agent Guide in Claude Code?
Run `npx skills add nansen-ai/nansen-cli --skill nansen-agent-guide -a claude-code`. Or copy the skill folder (skills/nansen-agent-guide in nansen-ai/nansen-cli) into .claude/skills/nansen-agent-guide in your project. Claude Code loads it when a task matches its description.
How do I install Nansen Agent Guide in Codex?
Run `npx skills add nansen-ai/nansen-cli --skill nansen-agent-guide -a codex`. Or copy the skill folder (skills/nansen-agent-guide in nansen-ai/nansen-cli) into .agents/skills/nansen-agent-guide in your project. Codex loads it when a task matches its description.
Can I use Nansen Agent Guide 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 nansen-ai/nansen-cli --skill nansen-agent-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nansen-agent-guide, .gemini/skills/nansen-agent-guide, .github/skills/nansen-agent-guide and .opencode/skills/nansen-agent-guide in your project.
What does Nansen Agent Guide need to run?
Going by SKILL.md and its folder, Nansen Agent Guide needs credentials named NANSEN_API_KEY. Our summary lists: A credential in NANSEN_API_KEY. Its frontmatter pre-approves these tools: Bash(nansen:*).
Does Nansen Agent Guide 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 Nansen Agent Guide 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 Nansen Agent Guide use?
Nansen Agent Guide 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 Nansen Agent Guide use?
About 948 tokens (SKILL.md is roughly 3.8k 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 Nansen Agent Guide?
Skills that share tags, products or a category with Nansen Agent Guide: Hypothesis Generation (spacering-net/codeg, 3.9k stars), Nature Paper Card (Yuan1z0825/nature-skills, 47k stars), Hypothesis Generation (K-Dense-AI/claude-scientific-writer, 2.4k stars) and Good Question (Rimagination/good-question, 305 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Nansen Agent Guide?
nansen-ai (a GitHub organization) maintains it in nansen-ai/nansen-cli, which has 139 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on October 9, 2026.
Source: nansen-ai/nansen-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.