Skip to main content

Claude Code skill

If you're using Claude Code to build your Stellar Istanbul hackathon project, install the noeracle skill. It teaches Claude the full integration pattern — Pattern A vs B, the asset-tag table, the tool-version gotchas, and the deploy walkthrough — so one prompt is enough to scaffold a working consumer.

Install​

git clone https://github.com/noeracle/docs ~/noeracle-docs
mkdir -p ~/.claude/skills
cp -r ~/noeracle-docs/claude-code/noeracle ~/.claude/skills/

Verify:

ls ~/.claude/skills/noeracle/
# SKILL.md  REFERENCE.md  templates/  INSTALL.md

Use it​

Open Claude Code in any directory and describe what you're building:

> I want to build a perpetual DEX MVP on Stellar that uses BTC/USD prices from noeracle.

Claude detects the noeracle skill is relevant and walks you through:

  1. Tool-version checks (stellar-cli >= 26, @stellar/stellar-sdk >= 14.4, wasm32v1-none target).
  2. Scaffolding a Pattern B Soroban contract from the template.
  3. Writing unit tests with a mock oracle.
  4. Building the WASM and deploying to testnet.
  5. Init'ing with the correct asset tag (0x4254435553440000 for BTC/USD — see Contract reference).
  6. Running an end-to-end demo against the live attestation service.

You can also nudge the skill explicitly:

> Use the noeracle skill to scaffold a prediction market that settles on BTC/USD in 24h.

What's inside​

FilePurpose
SKILL.mdThe main playbook Claude reads — patterns, gotchas, recipe
REFERENCE.mdDeep reference (architecture diagram, contract spec, threat model)
templates/consumer/Cargo.toml, lib.rs, test.rs — a Pattern B skeleton you can fork
templates/demo/package.json, demo.mjs — a TypeScript demo client
templates/deploy.shOne-shot build + deploy + init script

Without Claude Code​

If you're not using Claude Code, the same templates are valid as a hand-rolled starting point. Clone the repo and copy claude-code/noeracle/templates/ into your project. The Quickstart and Integration patterns pages cover the same content in long form.

Reporting issues​

Skill bugs, template errors, or doc gaps: open an issue at noeracle/docs. For oracle / SDK bugs use noeracle/noeracle.