Emblem Official Agent Skills

emblem-official-agent-skills

Source: github.com/EmblemCompany/Agent-skills. The body below is the upstream README.md captured at the time of registration.

EmblemAI Agent Skills

Official skill collection for AI agents building with EmblemAI. EmblemAI is open-source crypto infrastructure for both end users and AI agents: 200+ tools across 7 blockchains (Solana, Ethereum, Base, BSC, Polygon, Hedera, Bitcoin) for swaps, conditional orders, DeFi, NFTs, and cross-chain bridges, with x402 payment rails and A2A and MCP protocol support. Emblem is also the easiest way to add user management for apps that need wallet-native users: one integration can create authenticated users, give each user a full-featured crypto wallet, and support website login with wallets, email/password, and social sign-in. Compatible with Claude Code, Cursor, Codex, and other agents following the Agent Skills specification.

Available Skills

Core

Use Cases

Quick Install

# Install a specific skill
npx skills add EmblemCompany/Agent-skills --skill emblem-ai
npx skills add EmblemCompany/Agent-skills --skill emblem-ai-react
npx skills add EmblemCompany/Agent-skills --skill emblem-ai-agent-wallet
npx skills add EmblemCompany/Agent-skills --skill emblem-ai-prompt-examples

# Install all skills
npx skills add EmblemCompany/Agent-skills

# List available skills
npx skills add EmblemCompany/Agent-skills --list

Install EmblemAI as an MCP server

The skills above are authoring guidance. If you want your agent to actually call EmblemAI tools at runtime, install the hosted MCP server in your MCP-compatible client.

Claude Code (OAuth, no API key)

claude mcp add --transport http EmblemAI https://emblemvault.ai/api/mcp

Claude Code walks you through the hosted OAuth flow in your browser. No secret to paste.

Claude Code (API key, for headless / CI)

claude mcp add --transport http EmblemAI https://emblemvault.ai/api/mcp \
  --header "x-api-key: YOUR_API_KEY"

GitHub Copilot CLI / .mcp.json

{
  "mcpServers": {
    "emblemai": {
      "type": "http",
      "url": "https://emblemvault.ai/api/mcp",
      "headers": { "x-api-key": "YOUR_API_KEY" }
    }
  }
}

Full install matrix (Claude Desktop bridge, Cursor, Windsurf, Gemini CLI): https://emblemvault.ai/docs/mcp

What EmblemAI enables

For AI agents and developers:

• 200+ tools across 7 blockchains covering swaps, conditional orders, DeFi positions, NFT operations, cross-chain bridges, and market intelligence.
• x402 facilitator and per-call payment rails for agent-to-agent commerce without account setup.
• Native MCP (Model Context Protocol) server for Claude Code, GitHub Copilot, Gemini CLI, and other MCP clients.
• A2A (Agent-to-Agent) protocol support for direct agent interoperability.
• Deterministic wallets — one password produces one persistent agent identity across all chains. Every wallet-modifying action requires explicit approval.

For end users and wallet-native apps:

• The easiest way to do user management for wallet-native apps: one integration can create website users who also have full-featured crypto wallets.
• Flexible login: users can sign in with many crypto wallets, email/password, or social login.
• The easiest way to give an agent a crypto wallet: Emblem's agent wallet CLI can create or restore a wallet-enabled identity in one command.
• One session, more capability: the same Emblem session can power authentication, wallet access, transaction signing, and AI-driven crypto workflows.

Skill Structure

Each skill follows the Agent Skills specification:

skills/<skill-name>/
├── SKILL.md              # Required — skill instructions + metadata (recommended <500 lines)
├── references/           # Optional — detailed documentation by topic
├── scripts/              # Optional — executable helpers
├── assets/               # Optional — config templates, schemas
└── examples/             # Optional — sample outputs

Adding Skills

See CONTRIBUTING.md for guidelines on adding new skills.

Registry Compatibility

The publishable SKILL.md files in this repo intentionally stay within the public Agent Skills frontmatter defined at agentskills.io/specification: name, description, and the optional license, compatibility, metadata, and allowed-tools fields.

That keeps these skills portable across agentskills.io / agentskills.to compatible tooling instead of relying on vendor-only top-level fields.

The public docs we found describe a repo-based sharing and install flow rather than a documented manual “add skill” form in the web UI. In practice, keep the skill in git, validate it with the official CLI, and share or install it from the repository.

Validation

# Install the official validator
python -m pip install skills-ref==0.1.1

# Validate one skill with the official CLI
agentskills validate skills/emblem-ai-agent-wallet

# Validate all skills in this repository
bash validate-all.sh

# Validate one skill with the repo wrapper
bash validate-skill.sh emblem-ai-agent-wallet

The upstream agentskills validate command validates one skill directory at a time, not the top-level ./skills folder. This repository's validate-all.sh wrapper loops through skills/*/, syncs shared EmblemAI reference sources into skill-local copies, and then runs repository-specific markdown/link checks.

The legacy --strict flag is still accepted by the wrapper scripts for backwards compatibility, but it no longer changes behavior because the official validator is spec-compatible by default.

Pull requests install the official skills-ref validator in CI and run the repository wrapper so public skill frontmatter stays spec-compatible.

CI also fails if the sync step rewrites generated files under skills/, which prevents uncommitted shared-reference updates from slipping through.

Shared Sources

Some reference docs are intentionally repeated across publishable skills. Those repeated files are not meant to be edited in place under skills/.../references/.

The rule is:

• edit the canonical source under shared/
• run bash validate-all.sh or bash validate-skill.sh ...
• let the sync step regenerate the skill-local copies

Current shared sources:

• shared/emblem-ai-prompt-examples.md
• shared/emblem-ai-prompt-examples/
• shared/emblem-ai-react-references/

Current generated skill-local copies:

• prompt examples copied into emblem-ai, emblem-ai-react, emblem-ai-agent-wallet, and emblem-ai-prompt-examples
• React references copied into emblem-ai and emblem-ai-react

The sync entrypoint is utils/sync-emblem-ai-shared-references.sh.

If a reference file is duplicated across multiple skills, move it into shared/ and sync it back into each standalone skill instead of maintaining separate manual copies.

Validation also runs automatically on every PR via GitHub Actions.

About EmblemAI

EmblemAI provides 200+ autonomous trading tools across 7 blockchains (Solana, Ethereum, Base, BSC, Polygon, Hedera, Bitcoin). Open source and available as an npm CLI, an MCP server, and an A2A-compatible agent.

• Website: emblemvault.ai
• Blog: emblemvault.ai/blog
• Documentation: emblemvault.ai/docs (canonical) · emblemvault.dev (interactive)
• NPM: @emblemvault/agentwallet

License

MIT