souldinals

Inscribes a soul.md as a child ordinal on Bitcoin L1 via Unisat API.

9|43|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/aibtcdev/skills --skill souldinals-aibtcdev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: souldinals
Source: https://github.com/aibtcdev/skills/tree/main/souldinals
Command: npx skills add https://github.com/aibtcdev/skills --skill souldinals-aibtcdev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires commander.

What problem does it solve?

Souldinals provides a structured workflow to attach soul.md content as child ordinals on the Bitcoin L1, enabling provenance and trait encoding for agents within a collection.

Core Features & Use Cases

  • Inscribe a soul.md as a child inscription under a genesis parent, using a two-step commit/reveal workflow.
  • List, load, and display traits from soul inscriptions stored on the wallet and surfaced via the Unisat Ordinals API.
  • Validate and parse soul traits from Markdown content to expose identity, values, focus areas, and custom sections for downstream tooling.

Quick Start

Run bun run souldinals/souldinals.ts inscribe-soul --parent-inscription-id <GENESIS_ID> to begin the two-step workflow.

Frequently Asked Questions about souldinals

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I inscribe a soul.md file as a child ordinal on Bitcoin?

To inscribe a soul.md as a child ordinal on Bitcoin, you use a two-step commit and reveal workflow to attach the content under a genesis parent inscription. This process encodes agent identity and traits directly on Bitcoin L1.

What is the process to encode agent identity and traits using Bitcoin inscriptions?

Encoding agent identity uses child ordinals to attach soul.md content to a parent inscription on Bitcoin L1. The structured workflow validates and parses Markdown content to expose identity, values, and focus areas for downstream tooling.

How do I list and load traits from ordinals stored in my wallet?

You can list, load, and display traits from soul inscriptions by fetching content and metadata via the Unisat Ordinals API. This allows you to surface structured identity data stored across wallets on Bitcoin L1.

Does the child inscription workflow require Unisat Ordinals API support?

Yes, the workflow to list, load, and display soul inscriptions relies on Unisat Ordinals API support. It is required to fetch the necessary content and metadata from the wallet to produce structured outputs.

How do I start the commit and reveal transaction workflow for Bitcoin ordinals?

You start the commit and reveal workflow by running the inscribe-soul command with your genesis parent inscription ID. This initiates the process of constructing and signing transactions to attach your child ordinal.

Why do I need to enforce wallet unlocks when creating Bitcoin inscriptions?

Enforcing wallet unlocks is required to construct and sign the commit and reveal transactions for child ordinals. This security step ensures the wallet can successfully broadcast the Bitcoin L1 inscription data.