Merge pull request #4 from axioma-ai-labs/fix/self-contained-skills-and-readme-banner

Make skills self-contained, fix stale docs, add README banner

Author: 0xspacecreated

CONTRIBUTING.md

@@ -35,7 +35,11 @@
 
 5. Add a row to the skills table in [`README.md`](README.md).
 
-6. Validate before committing:
+6. Add the skill to the "Using the skills" list in
+   [`agents/AGENTS.md`](agents/AGENTS.md) - that file is the shared context for
+   non-Claude agents and must list every skill.
+
+7. Validate before committing:
 
    ```bash
    node scripts/validate-skills.mjs
@@ -51,3 +55,6 @@
   imperative.
 - Document failure modes (error codes, rate limits) - agents need them to
   recover.
+- Keep each skill self-contained. A skill can be installed on its own, so it
+  must not link to files in a sibling skill - inline what it needs, or link to
+  the official docs at <https://neuroapi.neurobro.ai/docs>.

README.md

@@ -1,4 +1,8 @@
-# Neurobro Skills
+<p align="center">
+  <img src="assets/neurobro-skills.png" alt="Neurobro Skills: Agent skills for the NeuroAPI financial market research API" width="100%">
+</p>
+
+<h1 align="center">Neurobro Skills</h1>
 
 Agent skills for **[NeuroAPI](https://neuroapi.neurobro.ai)** - Neurobro's
 paid public API for financial market research. These skills teach AI coding

agents/AGENTS.md

@@ -26,6 +26,12 @@ relevant to the task:
 - `neurobro-market-research` - financial market research via `/agent/ask`:
   equity and crypto analysis, technical setups, fundamental research, macro
   outlooks, multi-asset investigations.
+- `neurobro-meme-hunting` - discover and risk-vet trending and newly launched
+  memecoins: scan DEX pools, filter by liquidity and age, audit for honeypots,
+  rug-pull risk, and holder concentration.
+- `neurobro-trading-setup` - build structured trade setups: entry zones,
+  stop-loss, take-profit targets, and risk/reward ratios from technical
+  analysis and derivatives positioning.
 
 Each `SKILL.md` carries the full instructions, including request/response
 schemas, mode selection, billing, error handling, and rate limits.

assets/neurobro-skills.png

@@ -203,6 +203,8 @@ error class:
   to sort out billing, then stop.
 - **Adjust, then retry** - `403 mode_not_in_plan`: the `mode` isn't on the
   caller's plan; retry with `smart` or `fast`.
+- **Wait, then retry** - `409`: a call with the same `Idempotency-Key` is
+  still in flight; wait briefly, then retry the same request.
 - **Back off and retry** - `429` (honour `Retry-After`, cap at 3 attempts) and
   `503` (agent saturated; exponential backoff; no quota charged).
 - **`500`** - server-side bug; retry only idempotent calls, once.

skills/neurobro-market-research/SKILL.md

@@ -49,9 +49,8 @@ curl -s https://api.neurobro.ai/api/v1/agent/ask \
   -d '{"prompt": "<your prompt>", "mode": "smart"}' | jq -r .answer
 ```
 
-For the full request/response schema, status codes, rate limits, and key
-setup, see the `neurobro-market-research` skill and its
-`references/endpoints.md`.
+For the full request/response schema, status codes, and rate limits, see the
+official docs: <https://neuroapi.neurobro.ai/docs>.
 
 ## The hunt: discover, filter, audit, rank
 
@@ -179,6 +178,5 @@ routinely go to zero on momentum alone.
 
 ## Reference
 
-Full NeuroAPI endpoint reference - request/response schema, status codes,
-rate limits, and key setup - lives in the `neurobro-market-research` skill
-(`references/endpoints.md`). Official docs: <https://neuroapi.neurobro.ai/docs>.
+Full NeuroAPI endpoint reference - request/response schema, status codes, and
+rate limits - is in the official docs: <https://neuroapi.neurobro.ai/docs>.

skills/neurobro-meme-hunting/SKILL.md

@@ -48,9 +48,8 @@ curl -s https://api.neurobro.ai/api/v1/agent/ask \
   -d '{"prompt": "<your prompt>", "mode": "smart"}' | jq -r .answer
 ```
 
-For the full request/response schema, status codes, rate limits, and key
-setup, see the `neurobro-market-research` skill and its
-`references/endpoints.md`.
+For the full request/response schema, status codes, and rate limits, see the
+official docs: <https://neuroapi.neurobro.ai/docs>.
 
 ## The workflow: context, setup, validate
 
@@ -183,6 +182,5 @@ curl -s https://api.neurobro.ai/api/v1/agent/ask \
 
 ## Reference
 
-Full NeuroAPI endpoint reference - request/response schema, status codes,
-rate limits, and key setup - lives in the `neurobro-market-research` skill
-(`references/endpoints.md`). Official docs: <https://neuroapi.neurobro.ai/docs>.
+Full NeuroAPI endpoint reference - request/response schema, status codes, and
+rate limits - is in the official docs: <https://neuroapi.neurobro.ai/docs>.