arklabshq
45 verified skills135 total stars
add-project
Analyze a project repository and add it to the Arkadian documentation registry with standardized structure. Use when: user provides a path to a new project to onboard.
documentation3
arkd-offchain-tx
Off-chain transaction processing in arkd - Ark TX and checkpoint TX construction, submission, and finalization
testing3
ark-ops
Operational hub for Ark ecosystem tasks. Routes to ark-developer for environment/testing/debugging, or handles simple queries directly.
development3
ark-sdk-client-init
SDK client initialization and configuration - client types, wallet types, stores, and connection setup
tools3
skills/ark-wallet-dev
# Ark Wallet Development Skill ## SKILL TYPE: Hybrid Router + Reference This skill helps with building Ark protocol wallets. It provides quick reference for common operations and routes to detailed documentation for complex topics. ## USE WHEN User requests related to: - Building Ark wallets (Go or TypeScript) - Using go-sdk or @arkade-os/sdk - VTXO operations (send, receive, settle, redeem) - Wallet storage backends - Server communication (gRPC, REST) - Key management (BIP39, BIP32) - Light
development3
bitcoin-l2-research
Comprehensive Bitcoin and Layer-2 protocol research using parallel Claude agents. Specialized for Bitcoin Core, Lightning, Ark, and L2 scaling solutions. Three modes (Quick/Standard/Deep) with timeout management and multi-source validation.
testing3
browser-testing
Browser automation and visual testing for web development using Playwright MCP
tools3
create-operational-sop
Generate validated operational SOPs for Ark ecosystem projects by testing commands before documenting them. Use when: user wants to create or audit SOPs for a project.
testing3
fulmine-gha
Simulate fulmine GitHub Actions CI pipeline locally. Runs lint, vet, build, unit tests, and integration tests (MANDATORY). Optionally proto lint and DB vet — matching the real CI checks that run on PRs.
development3
fulmine-prod-debug
Debug and investigate fulmine production issues. Downloads logs and SQLite datadir from remote Docker containers, and queries the Boltz PostgreSQL database remotely. Analyzes errors and queries databases for root cause analysis. Use when: (1) investigating fulmine production errors or failures, (2) checking swap/vHTLC/delegate task status in prod, (3) analyzing fulmine logs for recent issues, (4) debugging VTXO or transaction problems on mainnet, (5) inspecting Boltz swap state in PostgreSQL. Triggers on: "fulmine prod", "production logs", "prod errors", "check prod fulmine", "debug fulmine", "fulmine mainnet issue", "boltz db", "boltz prod".
development3
skills/fulmine-vhtlc
# Fulmine VHTLC (Virtual Hash Time-Locked Contract) ## Overview VHTLCs are the building block for Lightning-Ark atomic swaps in Fulmine. They enable trustless swaps between Lightning Network and Ark by creating virtual UTXOs with hash-locked and time-locked spending conditions. ## Key Files | File | Purpose | |------|---------| | `pkg/vhtlc/vhtlc.go` | Core VHTLC script construction | | `pkg/vhtlc/opts.go` | VHTLC options and closure builders | | `pkg/vhtlc/utils.go` | Script parsing and val
development3
pm-checklist
RESTRICTED to ark-project-manager. Generate custom quality checklists for validating requirements.
testing3
pm-plan
RESTRICTED to ark-project-manager. Execute implementation planning workflow to generate design artifacts.
content-media3
pm-spec
RESTRICTED to ark-project-manager. Create or update feature specifications from natural language descriptions.
testing3
remove-project
Remove a project from the Arkadian documentation registry and delete all associated documentation files. Use when: user wants to deregister a project.
testing3
update-project
Update project documentation based on new commits and changes in the repository. Use when: user wants to sync docs after project changes.
documentation3
ark-sdk-payments
Off-chain payment operations with go-sdk - SendOffChain, coin selection, receivers, change handling
development3
arkd-dev-loop
Fast iteration loop for developing arkd locally. Smart pre-flight detects running services, sets up infrastructure, manages wallet state, then iterates with build-test-fix cycles including mandatory log capture.
development3
arkd-makefile-ref
Quick reference for arkd Makefile targets. Use before building, generating code, or running linters. Covers proto generation, build, sqlc, lint, and explains why make test must NEVER be used.
development3
gosdk-gha
Simulate go-sdk GitHub Actions CI pipeline locally. Runs lint, vet, build, unit tests, and integration tests (MANDATORY). Optionally proto lint — matching the real CI checks that run on PRs.
development3
skills/fulmine-submarine-swap
# Fulmine Submarine Swap (ARK → Lightning) ## Overview A submarine swap allows Fulmine users to send payments to Lightning Network invoices using their ARK funds. The user locks funds in a VHTLC that Boltz can claim once the Lightning invoice is paid. ## Flow Diagram ``` 1. User has Lightning invoice to pay 2. Fulmine creates submarine swap with Boltz 3. Boltz provides VHTLC parameters and address 4. Fulmine funds VHTLC with ARK VTXOs 5. Boltz detects funding, pays Lightning invoice 6. Boltz
data-ai3
ark-sdk-batch-session
Batch session event handling and round participation - joining rounds, signing trees, processing events
development3
skills/ark-testing-patterns
# Ark Testing Patterns ## Overview This skill covers testing patterns across the Ark ecosystem: E2E tests with nigiri (Bitcoin regtest), unit tests with mocks, table-driven tests, and multi-participant concurrent testing patterns. ## Key Files | Repository | File | Purpose | |------------|------|---------| | arkd | `internal/test/e2e/e2e_test.go` | E2E integration tests | | arkd | `internal/test/e2e/utils_test.go` | Test utilities (nigiri, faucet) | | arkd | `internal/infrastructure/tx-build
development3
skills/ark-progress-tracking
Progress tracking and reporting across Ark ecosystem (12 projects) for stakeholder visibility
business3
arkd-round-lifecycle
Round lifecycle management in arkd - stages, events, state machine, intent registration, finalization
tools3
analyse-arkadian-session
Analyse an Arkadian orchestrator session - read transcripts, logs, and artifacts to understand what happened and suggest improvements. Use when: user wants to debug or review a past session.
development3
skills/ark-repository-patterns
# Ark Repository Patterns ## Overview This skill covers the repository and data store patterns used across the Ark ecosystem: hexagonal architecture ports/adapters, RepoManager aggregators, multi-backend support (badger, sqlite, postgres), live stores for ephemeral state, and event channels for reactive updates. ## Key Files | Repository | File | Purpose | |------------|------|---------| | arkd | `internal/core/ports/repo_manager.go` | RepoManager port interface | | arkd | `internal/core/por
development3
ark-musig2-signing
MuSig2 distributed signing protocol for Ark transaction trees - nonce generation, aggregation, partial signatures
tools3
ark-bitcoin-primitives
Core Bitcoin/Taproot knowledge for Ark context - scripts, closures, PSBTs, Schnorr signatures
tools3
arkd-gha
Simulate arkd GitHub Actions CI pipeline locally. Runs lint, vet, build, unit tests, and integration tests (MANDATORY). Optionally proto lint — matching the real CI checks that run on PRs.
development3
arkd-grpc-api
arkd gRPC API and protobuf definitions - service endpoints, message types, streaming events
development3
ark-sdk-settlement
Settlement and exit operations - Settle, CollaborativeExit, Unroll, fee estimation
development3
ark-vtxo-model
VTXO lifecycle, domain model, states, expiration, and tree construction in Ark protocol
data-ai3
arkd-tree-construction
VTXO and connector tree construction - building batch outputs, tree structures, forfeit transactions
development3
auto-improve
Self-improvement loop for arkadian. Launches arkadian -d with a GitHub issue, polls until done, evaluates per-agent criteria, reads transcripts on failure, improves prompts, deletes worktree, and relaunches. Loops until passing or max iterations.
data-ai3
dev-implement
RESTRICTED to ark-developer. Execute the implementation plan by processing and completing all tasks.
development3
skills/fulmine-batch-settlement
# Fulmine Batch Settlement for VHTLCs ## Overview Batch settlement allows Fulmine to settle VHTLCs (claim or refund) by participating in an ASP round rather than submitting individual off-chain transactions. This is more efficient when VTXOs are "recoverable" (about to expire). ## When to Use Batch Settlement ```go // pkg/swap/swap.go:186-193 // If VTXO is recoverable (can be swept by ASP), use batch settlement if vtxo.IsRecoverable() && vtxo.Amount >= h.config.Dust { txid, err := h.Sett
development3
noa-cli
CLI reference for noa and Ark Indexer REST API — tools for decoding and inspecting Bitcoin/Ark primitives. Use when working with Ark addresses, Bitcoin scripts, taproot trees, PSBTs, note closures, VTXOs, commitment txs, forfeit txs, or connector trees. Covers all noa subcommands (address, script, note, taptree, psbt) and Indexer endpoints (GetCommitmentTx, GetVtxos, GetVtxoTree, GetVtxoChain, GetVirtualTxs, etc.). Includes a step-by-step recipe for investigating any VTXO from an outpoint.
tools3
skills/fulmine-reverse-swap
# Fulmine Reverse Swap (Lightning → ARK) ## Overview A reverse swap allows users to receive Lightning payments into their ARK wallet. Boltz locks funds in a VHTLC that Fulmine can claim by revealing the preimage after the Lightning invoice is paid. ## Flow Diagram ``` 1. User wants to receive Lightning payment 2. Fulmine generates preimage (keeps secret) 3. Fulmine creates reverse swap with Boltz (provides preimage hash) 4. Boltz returns Lightning invoice + VHTLC address 5. User shares invoi
data-ai3
pm-analyze
RESTRICTED to ark-project-manager. Perform cross-artifact consistency and quality analysis.
testing3
pm-clarify
RESTRICTED to ark-project-manager. Identify underspecified areas in specs and ask targeted clarification questions.
testing3
pm-constitution
RESTRICTED to ark-project-manager. Create or update project constitution with principles and guidelines.
testing3
pm-tasks
RESTRICTED to ark-project-manager. Generate actionable, dependency-ordered task lists organized by user story.
tools3
fulmine-dev-loop
Fast iteration loop for developing fulmine locally. Three infrastructure modes (internal-only, real-boltz, mock-boltz), smart pre-flight checks, and a build-test-fix iteration loop with mandatory log capture.
development3
skills/fulmine-chain-swap
# Fulmine Chain Swap (ARK ↔ BTC On-Chain) ## Overview Chain swaps enable atomic swaps between ARK VTXOs and on-chain Bitcoin UTXOs. Unlike submarine swaps (which use Lightning), chain swaps work directly between ARK and Bitcoin mainnet. ## Two Directions | Direction | User Sends | User Receives | Entry Point | |-----------|------------|---------------|-------------| | ARK → BTC | ARK VTXO (via VHTLC) | BTC UTXO | `ChainSwapArkToBtc()` | | BTC → ARK | BTC UTXO | ARK VTXO (from VHTLC) | `Chain
data-ai3