Skip to content

x402agent/SolanaOS / skills/pump-ai-agents

pump-ai-agents

Verified

AI agent integration layer for the Pump SDK — agent instruction files, .well-known discovery, LLM context documents, 15+ skill files, MCP server prompts, and terminal management rules for GitHub Copilot and Gemini.

AI Agent Integration — Agent Scaffolding & Discovery

Configure AI agents (GitHub Copilot and Gemini) to work effectively with the Pump SDK through instruction files, skill registries, and MCP server integration.

Agent Instruction Files

FileAgentPurpose
AGENTS.mdUniversalProject overview, architecture, security rules
COPILOT.mdGitHub CopilotInstructions pointer
GEMINI.mdGoogle GeminiInstructions pointer
.github/copilot-instructions.mdCopilot ChatSDK patterns, security rules

.well-known Discovery Files

FilePurpose
.well-known/ai-plugin.jsonAI plugin manifest
.well-known/agent.jsonAgent capabilities and config
.well-known/skills.jsonSkills registry (15+ skills)
.well-known/security.txtSecurity contact information

LLM Context Documents

FileSizePurpose
llms.txtShortQuick reference for LLMs
llms-full.txtLongComprehensive LLM context

Skills Registry Schema

{
    "schema_version": "v1",
    "name": "pump-fun-sdk",
    "skills": [
        {
            "id": "pump-sdk-core",
            "name": "Pump SDK Core",
            "description": "...",
            "path": ".github/skills/pump-sdk-core.skill.md",
            "tags": ["typescript", "solana", "sdk"]
        }
    ]
}

Terminal Management (Agent Rules)

  • Always use background terminals (isBackground: true) for every command
  • Always kill the terminal after completion — never leave terminals open
  • Do not reuse foreground shell sessions
  • If a terminal appears unresponsive, kill it and create a new one

Security Invariants for Agents

  • ONLY official Solana Labs crypto: solana-sdk, @solana/web3.js, solana-keygen
  • Zeroize all key material after use
  • File permissions 0600 for keypairs
  • No network calls for key generation
  • All amounts use BN (bn.js) — never JavaScript number for financial math
  • createInstruction (v1) is deprecated — use createV2Instruction

MCP Server Integration

{
    "mcpServers": {
        "solana-wallet": {
            "command": "npx",
            "args": ["-y", "@pump-fun/mcp-server"],
            "transportType": "stdio"
        }
    }
}

Patterns to Follow

  • Keep agent instruction files concise and actionable
  • Point agents to specific skill files for domain knowledge
  • Update skills.json when adding or modifying skill files
  • Maintain consistency between AGENTS.md, COPILOT.md, and GEMINI.md

Common Pitfalls

  • Agent instruction files that are too long get truncated or ignored
  • Missing skills from skills.json means agents won't discover them
  • Terminal management rules are critical in Codespaces — stale terminals block operations
  • MCP server must be registered in the agent's tool configuration
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall