We Open-Sourced Our Hive Development Brain — A Claude Code Skill for Building on Hive

If you use Claude Code and want to build on the Hive blockchain, we just made your life significantly easier.

Mantequilla-Soft is releasing hive-master-skill. A free, open-source Claude Code skill that gives Claude deep, production-grade expertise in Hive blockchain development.

This isn't a copy-paste of the Hive developer docs. This is battle-tested knowledge extracted from patterns across 40+ production Hive applications, including real workarounds, gotchas, and fixes that you won't find documented anywhere else.

What Is a Claude Code Skill?

For those unfamiliar: Claude Code is Anthropic's command-line tool for agentic coding. You describe what you want, and Claude writes, edits, and runs the code for you directly in your terminal.

Skills are knowledge packs that you can install to give Claude specialized expertise in a specific domain. Think of them as teaching Claude how an experienced developer in that field actually works, not just the API surface, but the patterns, traps, and production workarounds that take years to accumulate.

When you install hive-master-skill, Claude suddenly knows:

• How to structure Hive API calls with proper node failover
• Which key type to use for which operation
• That beneficiaries must be sorted alphabetically (or your transaction silently fails)
• That dhive's auto-failover is broken on React Native
• How to calculate vote values, mana regeneration, and RC costs
• The correct way to sign image uploads to images.hive.blog
• And about 3,800 lines more of this kind of practical knowledge

What's Inside

The skill is organized into focused reference files that Claude loads on demand:

The Battle-Tested File

This is honestly the most valuable part. Here's a taste of what's in battle-tested.md:

1. dhive does NOT auto-failover on React Native — You must implement manual node rotation. We include the complete working implementation.
2. Never retry broadcast operations — A timeout doesn't mean it failed. The transaction may already be on-chain. Retrying creates duplicates.
3. Beneficiaries must be sorted alphabetically — The protocol requires it but the error message is cryptic. Just .sort() by account name.
4. iOS ph:// URIs break image uploads — The Photos framework URI needs to be normalized through expo-image-manipulator before uploading.
5. Hive timestamps need a 'Z' suffix — Without it, JavaScript interprets them as local time, and your dates are off by hours.
6. posting_json_metadata vs json_metadata — Two different fields, two different key requirements. Always check posting_json_metadata first.
7. TUS upload resume fails on some services — embed.3speak.tv doesn't return Upload-Length on HEAD requests, so resume always fails. You need to clear stale fingerprints.

There are 18 of these in total, each with the problem description, the fix, and working code. Some of these took hours or days to diagnose in production. Now Claude knows about all of them before writing a single line of code.

How to Install

Option 1: Personal skill (available across all your projects)

git clone https://github.com/Mantequilla-Soft/hive-master-skill.git ~/.claude/skills/hive-master

That's it. The skill is now available in every project on your machine.

Option 2: Per-project (committed to your repo)

mkdir -p .claude/skills
git clone https://github.com/Mantequilla-Soft/hive-master-skill.git .claude/skills/hive-master
rm -rf .claude/skills/hive-master/.git
git add .claude/skills/hive-master
git commit -m "Add hive-master skill"

Option 3: Git submodule (stays updated)

git submodule add https://github.com/Mantequilla-Soft/hive-master-skill.git .claude/skills/hive-master

Once installed, Claude auto-detects when you're doing Hive work and loads the relevant knowledge. You can also invoke it manually with /hive-master or pass a topic like /hive-master wallet.

Why We Built This

At Mantequilla-Soft, we maintain and build tools for the Hive ecosystem — including infrastructure for 3Speak, open-source developer tooling, and community projects. Between our team, we've collectively hit every sharp edge that Hive development has to offer.

When Claude Code started supporting skills, we realized we could package all of that accumulated knowledge and give it away. Every new developer building on Hive shouldn't have to rediscover that beneficiaries need sorting, or that dhive failover is broken on mobile, or that image uploads need the ImageSigningChallenge prefix.

This is our contribution to lowering the barrier for building on Hive. If Claude Code is becoming part of how developers work, then Hive should be a first-class citizen in that workflow.

Contributing

Found a new gotcha? Discovered a better pattern? PRs are welcome — especially for battle-tested.md. The goal is to capture the knowledge that saves hours of debugging.

Repository: github.com/Mantequilla-Soft/hive-master-skill
License: MIT

Built by menobass (@meno) and the Mantequilla-Soft team. Post by @eddiespino.

https://www.mantequilla-soft.com/

https://github.com/orgs/Mantequilla-Soft/repositories