Skip to content

[Skill Proposal] solana-actions-blinks-skill — Actions & Blinks for AI coding agents #115

Description

@gautammanak1

Problem statement

Builders and AI coding agents need to ship shareable on-chain interactions (tips, swaps, votes, sign-in) via Solana Actions and Blockchain Links (Blinks). The spec spans GET/POST/OPTIONS handlers, actions.json domain mapping, CORS, callback security, and wallet-facing blink URLs — but this knowledge is fragmented across docs, examples, and one-off repos. Without a curated skill, agents often produce non-compliant endpoints or depend on broken third-party preview tools.

Proposed solution

solana-actions-blinks-skill — an addon skill for the Solana AI Kit with:

  • Progressive disclosure via skill/SKILL.md and six focused modules (SOL tip, SPL/USDC, Jupiter swap, NFT mint, Realms vote, message sign-in)
  • Copy-paste Next.js templates using @solana/actions (createActionHeaders, createPostResponse)
  • Agents, slash commands, security module, and validation script
  • Live devnet demo with an embedded native Action client (works without dial.to / Blinks Inspector)

Ecosystem gap

Review of 128+ open bounty PRs shows no dedicated Actions / Blinks skill. This proposal fills that gap and complements solana-dev-skill with production Action/Blink patterns.

Links

Item URL
Bounty PR #113
Standalone repo https://github.com/gautammanak1/solana-actions-blinks-skill
Demo https://solana-actions-blinks-demo-nine.vercel.app
Action API https://solana-actions-blinks-demo-nine.vercel.app/api/actions/transfer-sol
Release https://github.com/gautammanak1/solana-actions-blinks-skill/releases/tag/v1.0.0

Latest submission sync: 2163011gautammanak1@2163011

Acceptance criteria (for maintainers)

  • Skill follows repo layout and passes ./solana-actions-blinks-skill/scripts/validate-skill.sh
  • Templates typecheck via npm ci && npm run test:ci in standalone repo
  • GET /api/actions/transfer-sol returns type: action with linked actions type: transaction
  • Demo home allows devnet wallet connect + tip via native blink UI
  • Documented as addon to solana-dev-skill, not a duplicate core skill
  • PR Submission: Add solana-actions-blinks-skill — Actions & Blinks with real SDK + Jupiter API #113 reviewed and merged per bounty process

Why it fits the Solana AI Kit

Actions/Blinks are the distribution layer for on-chain UX in social feeds, QR codes, and agent-generated links. Teaching agents the official SDK and spec reduces unsafe callbacks and broken blinks, and the live demo gives maintainers a reliable QA path when inspector tooling is down.

Submitted for Superteam Brasil · Solana AI Kit skills bounty.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions