Skip to content

Commit 41c0ed0

Browse files
Merge pull request #2 from axioma-ai-labs/feat/meme-hunting-trading-setup
Add neurobro-meme-hunting and neurobro-trading-setup skills
2 parents dbd3293 + 5dbd421 commit 41c0ed0

13 files changed

Lines changed: 474 additions & 64 deletions

File tree

‎.claude-plugin/marketplace.json‎

Lines changed: 38 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,15 +5,15 @@
55
"email": "support@neurobro.ai"
66
},
77
"metadata": {
8-
"description": "Agent skills for NeuroAPI — Neurobro's public API for financial market research",
8+
"description": "Agent skills for NeuroAPI - Neurobro's public API for financial market research",
99
"version": "0.1.0"
1010
},
1111
"plugins": [
1212
{
1313
"name": "neurobro-market-research",
1414
"source": "./skills/neurobro-market-research",
1515
"skills": "./",
16-
"description": "Run financial market research through the NeuroAPI agent — equity and crypto analysis, technical setups, fundamental research, macro outlooks, and multi-asset investigations via POST /agent/ask",
16+
"description": "Run financial market research through the NeuroAPI agent - equity and crypto analysis, technical setups, fundamental research, macro outlooks, and multi-asset investigations via POST /agent/ask",
1717
"keywords": [
1818
"neurobro",
1919
"neuroapi",
@@ -26,6 +26,42 @@
2626
],
2727
"category": "data-extraction",
2828
"version": "0.1.0"
29+
},
30+
{
31+
"name": "neurobro-meme-hunting",
32+
"source": "./skills/neurobro-meme-hunting",
33+
"skills": "./",
34+
"description": "Discover and risk-vet trending and newly launched memecoins through the NeuroAPI agent - scan trending DEX pools, filter by liquidity and age, and audit tokens for honeypots, rug-pull risk, and holder concentration",
35+
"keywords": [
36+
"neurobro",
37+
"neuroapi",
38+
"memecoin",
39+
"meme-hunting",
40+
"crypto",
41+
"rug-pull",
42+
"honeypot",
43+
"token-audit"
44+
],
45+
"category": "data-extraction",
46+
"version": "0.1.0"
47+
},
48+
{
49+
"name": "neurobro-trading-setup",
50+
"source": "./skills/neurobro-trading-setup",
51+
"skills": "./",
52+
"description": "Build structured trade setups through the NeuroAPI agent - entry zones, stop-loss, take-profit targets, and risk/reward ratios grounded in technical analysis and derivatives positioning",
53+
"keywords": [
54+
"neurobro",
55+
"neuroapi",
56+
"trading-setup",
57+
"trade-plan",
58+
"crypto",
59+
"stocks",
60+
"technical-analysis",
61+
"risk-reward"
62+
],
63+
"category": "data-extraction",
64+
"version": "0.1.0"
2965
}
3066
]
3167
}

‎.claude-plugin/plugin.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "neurobro-skills",
33
"version": "0.1.0",
4-
"description": "Agent skills for NeuroAPI — Neurobro's public API for financial market research",
4+
"description": "Agent skills for NeuroAPI - Neurobro's public API for financial market research",
55
"author": {
66
"name": "Neurobro",
77
"email": "support@neurobro.ai"

‎.env.example‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
1-
# Neurobro Skills — environment template.
1+
# Neurobro Skills - environment template.
22
#
33
# Copy this file to .env and fill in your key:
44
# cp .env.example .env
55
#
66
# .env is git-ignored, so your real key is never committed.
77

8-
# NeuroAPI key. Mint one in the dashboard → API Keys → Create key.
8+
# NeuroAPI key. Create one in the dashboard under API Keys > Create key.
99
# Keys look like: neuro_<random>
1010
NEUROAPI_API_KEY=

‎.gitignore‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Secrets — never commit a real key. .env.example is the committed template.
1+
# Secrets - never commit a real key. .env.example is the committed template.
22
.env
33
.env.*
44
!.env.example

‎CONTRIBUTING.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
## Adding a new skill
44

55
1. Create a directory under `skills/`. **The name must be prefixed
6-
`neurobro-`** — that prefix is what makes every skill discoverable under a
6+
`neurobro-`** - that prefix is what makes every skill discoverable under a
77
"Neurobro" search on [skills.sh](https://www.skills.sh).
88

99
```
@@ -47,7 +47,7 @@
4747

4848
- Never put a real API key in any tracked file. Skills read the key from the
4949
`NEUROAPI_API_KEY` environment variable.
50-
- Write instructions for an agent, not a human reader — be concrete and
50+
- Write instructions for an agent, not a human reader - be concrete and
5151
imperative.
52-
- Document failure modes (error codes, rate limits) — agents need them to
52+
- Document failure modes (error codes, rate limits) - agents need them to
5353
recover.

‎README.md‎

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,20 @@
11
# Neurobro Skills
22

3-
Agent skills for **[NeuroAPI](https://neuroapi.neurobro.ai)** — Neurobro's
3+
Agent skills for **[NeuroAPI](https://neuroapi.neurobro.ai)** - Neurobro's
44
paid public API for financial market research. These skills teach AI coding
55
agents (Claude Code, Cursor, Codex, Gemini CLI, and others) how to call
66
NeuroAPI correctly: choosing the right intelligence tier, handling billing
77
and rate limits, and writing prompts that produce useful research.
88

9-
**[Create an API key →](https://neuroapi.neurobro.ai)** · **[Read the docs →](https://neuroapi.neurobro.ai/docs)**
9+
[Create an API key](https://neuroapi.neurobro.ai) or [read the docs](https://neuroapi.neurobro.ai/docs).
1010

1111
## Skills
1212

1313
| Skill | What it does |
1414
| --- | --- |
15-
| [`neurobro-market-research`](skills/neurobro-market-research/) | Financial market research via the NeuroAPI agent — equity and crypto analysis, technical setups, fundamental research, macro outlooks, and multi-asset investigations. |
15+
| [`neurobro-market-research`](skills/neurobro-market-research/) | Financial market research via the NeuroAPI agent - equity and crypto analysis, technical setups, fundamental research, macro outlooks, and multi-asset investigations. |
16+
| [`neurobro-meme-hunting`](skills/neurobro-meme-hunting/) | Discover and risk-vet trending and newly launched memecoins - scan trending DEX pools, filter by liquidity and age, audit for honeypots, rug-pull risk, and holder concentration. |
17+
| [`neurobro-trading-setup`](skills/neurobro-trading-setup/) | Build structured trade setups - entry zones, stop-loss, take-profit targets, and risk/reward ratios grounded in technical analysis and derivatives positioning. |
1618

1719
Every skill name is prefixed `neurobro-`; more are added over time.
1820

@@ -35,7 +37,7 @@ Or as a Claude Code plugin:
3537

3638
1. [Create an API key](https://neuroapi.neurobro.ai) in the NeuroAPI dashboard
3739
under **API Keys**. Keys look like `neuro_<random>` and are shown only once.
38-
2. Make sure the account has an active plan — `/agent/ask` requires one.
40+
2. Make sure the account has an active plan - `/agent/ask` requires one.
3941
3. Provide the key via the `NEUROAPI_API_KEY` environment variable:
4042

4143
```bash
@@ -50,16 +52,16 @@ the committed template and holds no secret.
5052

5153
```
5254
.claude-plugin/ Claude Code plugin marketplace manifests
53-
.github/workflows/ CI — validates every SKILL.md on push
55+
.github/workflows/ CI - validates every SKILL.md on push
5456
agents/ Shared context for non-Claude agents (Codex, Gemini)
55-
scripts/ validate-skills.mjs — frontmatter checker
57+
scripts/ validate-skills.mjs - frontmatter checker
5658
skills/ One directory per skill, each with a SKILL.md
5759
```
5860

5961
## Contributing
6062

61-
New skills welcome — see [CONTRIBUTING.md](CONTRIBUTING.md).
63+
New skills welcome - see [CONTRIBUTING.md](CONTRIBUTING.md).
6264

6365
## License
6466

65-
MIT — see [LICENSE](LICENSE).
67+
MIT - see [LICENSE](LICENSE).

‎agents/AGENTS.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Neurobro Skills — agent context
1+
# Neurobro Skills - agent context
22

33
This repository provides skills for working with **NeuroAPI**, Neurobro's
44
paid public API for financial market research.
@@ -8,9 +8,9 @@ paid public API for financial market research.
88
- Base URL: `https://api.neurobro.ai/api/v1`
99
- Auth: `X-API-Key` header. Keys look like `neuro_<random>`. No OAuth, no
1010
`Authorization: Bearer`.
11-
- Core endpoint: `POST /agent/ask` — runs a financial research agent over a
11+
- Core endpoint: `POST /agent/ask` - runs a financial research agent over a
1212
natural-language `prompt` and returns an `answer`.
13-
- Free check: `GET /health` — verifies the key, consumes no quota.
13+
- Free check: `GET /health` - verifies the key, consumes no quota.
1414

1515
## API key
1616

@@ -23,7 +23,7 @@ Never hardcode it, print it, log it, or commit it. Locally, copy
2323
Each directory under `skills/` is one skill with a `SKILL.md`. Load the skill
2424
relevant to the task:
2525

26-
- `neurobro-market-research` — financial market research via `/agent/ask`:
26+
- `neurobro-market-research` - financial market research via `/agent/ask`:
2727
equity and crypto analysis, technical setups, fundamental research, macro
2828
outlooks, multi-asset investigations.
2929

‎gemini-extension.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "neurobro-skills",
3-
"description": "Agent skills for NeuroAPI — Neurobro's public API for financial market research.",
3+
"description": "Agent skills for NeuroAPI - Neurobro's public API for financial market research.",
44
"version": "0.1.0",
55
"contextFileName": "agents/AGENTS.md"
66
}

‎scripts/validate-skills.mjs‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -64,4 +64,4 @@ if (errors.length) {
6464
process.exit(1);
6565
}
6666

67-
console.log(`OK — ${dirs.length} skill(s) validated.`);
67+
console.log(`OK - ${dirs.length} skill(s) validated.`);

‎skills/neurobro-market-research/SKILL.md‎

Lines changed: 30 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: neurobro-market-research
3-
description: Runs financial market research through the NeuroAPI agent — equity and crypto analysis, technical setups, fundamental research, macro outlooks, and multi-asset investigations via POST /agent/ask. Use when the user asks for stock or token analysis, trade ideas, market commentary, earnings or macro questions, sector comparisons, or any financial research that needs live market reasoning.
3+
description: Runs financial market research through the NeuroAPI agent - equity and crypto analysis, technical setups, fundamental research, macro outlooks, and multi-asset investigations via POST /agent/ask. Use when the user asks for stock or token analysis, trade ideas, market commentary, earnings or macro questions, sector comparisons, or any financial research that needs live market reasoning.
44
license: MIT
55
---
66

@@ -9,7 +9,7 @@ license: MIT
99
NeuroAPI is Neurobro's paid public API. Its `/agent/ask` endpoint runs a
1010
financial research agent that answers natural-language questions about
1111
equities, crypto, macro, and cross-asset markets. This skill teaches an agent
12-
how to call it correctly — picking the right intelligence tier, handling
12+
how to call it correctly - picking the right intelligence tier, handling
1313
billing and rate limits, and writing prompts that produce useful research.
1414

1515
## Quick start
@@ -31,22 +31,22 @@ curl -s https://api.neurobro.ai/api/v1/agent/ask \
3131
- Researching a single stock or token (fundamentals, technicals, narrative)
3232
- Building bull/bear cases or trade setups
3333
- Comparing assets, sectors, or factors
34-
- Macro questions — rates, inflation, central-bank outlooks
34+
- Macro questions - rates, inflation, central-bank outlooks
3535
- Deep multi-asset investigations that need broad market coverage
3636

3737
Do **not** use this skill for trade execution, portfolio custody, or anything
38-
requiring guaranteed real-time quotes — NeuroAPI returns research and
38+
requiring guaranteed real-time quotes - NeuroAPI returns research and
3939
reasoning, not an order router or a market-data feed.
4040

4141
## Prerequisites
4242

4343
The API key is read from the `NEUROAPI_API_KEY` environment variable. **Never
4444
hardcode it in source, never print it, never paste it into a commit.**
4545

46-
1. Create a key in the NeuroAPI dashboard at <https://neuroapi.neurobro.ai>
47-
→ **API Keys** → **Create key**. The secret is shown once; keys look like
48-
`neuro_<random>`.
49-
2. Make sure the account has an active plan in **Pricing** — `/agent/ask`
46+
1. Create a key in the NeuroAPI dashboard at <https://neuroapi.neurobro.ai>:
47+
open **API Keys** and click **Create key**. The secret is shown once; keys
48+
look like `neuro_<random>`.
49+
2. Make sure the account has an active plan in **Pricing** - `/agent/ask`
5050
returns `402` without one.
5151
3. Provide the key to the environment. For local use, copy `.env.example` to
5252
`.env` (already git-ignored) and fill in `NEUROAPI_API_KEY`, then export it:
@@ -56,11 +56,11 @@ hardcode it in source, never print it, never paste it into a commit.**
5656
export NEUROAPI_API_KEY="neuro_..."
5757
```
5858

59-
Verify before doing real work — `/health` is free and consumes no quota:
59+
Verify before doing real work - `/health` is free and consumes no quota:
6060

6161
```bash
6262
curl -s https://api.neurobro.ai/api/v1/health \
63-
-H "X-API-Key: $NEUROAPI_API_KEY" | jq .authenticated # → true
63+
-H "X-API-Key: $NEUROAPI_API_KEY" | jq .authenticated # returns true
6464
```
6565

6666
## The endpoint
@@ -71,16 +71,16 @@ curl -s https://api.neurobro.ai/api/v1/health \
7171
| --- | --- |
7272
| `X-API-Key` | `neuro_...` (required) |
7373
| `Content-Type` | `application/json` |
74-
| `Idempotency-Key` | Optional. 1–255 printable ASCII chars; safe-retries a call. |
74+
| `Idempotency-Key` | Optional. 1-255 printable ASCII chars; safe-retries a call. |
7575

7676
Request body:
7777

7878
| Field | Type | Default | Notes |
7979
| --- | --- | --- | --- |
80-
| `prompt` | string | — | Required. 1–32,000 chars. The research question. |
80+
| `prompt` | string | - | Required. 1-32,000 chars. The research question. |
8181
| `mode` | enum | `smart` | `fast` \| `smart` \| `max`. See tiers below. |
82-
| `stream` | bool | `false` | `true` → SSE stream ending in `data: [DONE]\n\n`. |
83-
| `message_history` | array | `null` | Prior turns (max 50). Stateless — caller owns it. |
82+
| `stream` | bool | `false` | When `true`, an SSE stream ending in `data: [DONE]\n\n`. |
83+
| `message_history` | array | `null` | Prior turns (max 50). Stateless - caller owns it. |
8484

8585
Response (`stream=false`):
8686

@@ -93,7 +93,7 @@ Response (`stream=false`):
9393
}
9494
```
9595

96-
`request_id` is also returned in the `X-Request-Id` header — quote it when
96+
`request_id` is also returned in the `X-Request-Id` header - quote it when
9797
reporting issues.
9898

9999
## Choosing a mode
@@ -110,10 +110,10 @@ deliberately.
110110
- Default to `smart` for genuine research questions.
111111
- Use `fast` only for shallow lookups where depth doesn't matter.
112112
- Use `max` when the question spans many assets or demands the deepest
113-
reasoning. Calling `max` on a Starter key returns `403 mode_not_in_plan` —
113+
reasoning. Calling `max` on a Starter key returns `403 mode_not_in_plan` -
114114
fall back to `smart` rather than failing the task.
115115
- `cost_units` is what gets debited from billable quota. Don't reach for `max`
116-
by reflex; it costs 4× a `smart` call.
116+
by reflex; it costs 4x a `smart` call.
117117

118118
## Recipes
119119

@@ -131,7 +131,7 @@ curl -s https://api.neurobro.ai/api/v1/agent/ask \
131131
### Follow-up questions (multi-turn)
132132

133133
The API is stateless. To ask a follow-up, replay prior turns in
134-
`message_history` — roles are `"user"` and `"assistant"`.
134+
`message_history` - roles are `"user"` and `"assistant"`.
135135

136136
```python
137137
import os, httpx
@@ -178,12 +178,12 @@ curl -N https://api.neurobro.ai/api/v1/agent/ask \
178178

179179
The agent rewards specific, scoped prompts. For useful financial research:
180180

181-
- **Name the asset(s) precisely** — ticker plus exchange or chain when
181+
- **Name the asset(s) precisely** - ticker plus exchange or chain when
182182
ambiguous (`NVDA`, `BTC`, `ETH on mainnet`).
183-
- **State the angle** — fundamentals, technicals, valuation, catalysts, risk.
184-
- **Bound the timeframe** — "next two quarters", "into 2026", "since the last
183+
- **State the angle** - fundamentals, technicals, valuation, catalysts, risk.
184+
- **Bound the timeframe** - "next two quarters", "into 2026", "since the last
185185
earnings call". Markets move; an unbounded prompt invites stale framing.
186-
- **Ask for structure** — "give bull case, bear case, and key risks" produces
186+
- **Ask for structure** - "give bull case, bear case, and key risks" produces
187187
far more usable output than "what do you think about X".
188188
- **One question per call** for clean answers; use `message_history` to drill
189189
down rather than stuffing five questions into one prompt.
@@ -195,19 +195,19 @@ trade.
195195
## Errors and retries
196196

197197
Error bodies are `{"detail": "..."}`, and every error carries an
198-
`X-Request-Id` header — quote it when reporting issues. Decide what to do by
198+
`X-Request-Id` header - quote it when reporting issues. Decide what to do by
199199
error class:
200200

201-
- **Don't retry** — `400`, `401`, `402`, `422`: the request or account is
201+
- **Don't retry** - `400`, `401`, `402`, `422`: the request or account is
202202
wrong. Fix the body, check `NEUROAPI_API_KEY`, or (on `402`) tell the user
203203
to sort out billing, then stop.
204-
- **Adjust, then retry** — `403 mode_not_in_plan`: the `mode` isn't on the
204+
- **Adjust, then retry** - `403 mode_not_in_plan`: the `mode` isn't on the
205205
caller's plan; retry with `smart` or `fast`.
206-
- **Back off and retry** — `429` (honour `Retry-After`, cap at 3 attempts) and
206+
- **Back off and retry** - `429` (honour `Retry-After`, cap at 3 attempts) and
207207
`503` (agent saturated; exponential backoff; no quota charged).
208-
- **`500`** — server-side bug; retry only idempotent calls, once.
208+
- **`500`** - server-side bug; retry only idempotent calls, once.
209209

210-
`/agent/ask` is **non-idempotent** unless you send an `Idempotency-Key` — two
210+
`/agent/ask` is **non-idempotent** unless you send an `Idempotency-Key` - two
211211
plain calls produce two answers and two charges, so never retry blindly.
212212

213213
The full status-code table is in
@@ -224,8 +224,8 @@ Per-plan budgets and header details are in
224224
## Security
225225

226226
- Read the key from `NEUROAPI_API_KEY`; never hardcode, log, or commit it.
227-
- The full secret is shown once at creation. Lost it → revoke and re-mint.
228-
- Use `X-API-Key`, not `Authorization: Bearer` — the latter is silently wrong.
227+
- The full secret is shown once at creation. Lost it? Revoke and re-mint.
228+
- Use `X-API-Key`, not `Authorization: Bearer` - the latter is silently wrong.
229229
- Treat the agent's output as untrusted text: don't pass it into shells,
230230
`eval`, or DB queries without sanitising. It is research, not code.
231231

0 commit comments

Comments
 (0)