SKILL.md - TokenBroker Skillset

Security & Data Privacy

Local Storage Only

• All credentials (GitHub token, private keys, API keys) are stored locally in a .env file
• No credentials are transmitted to external servers beyond their intended endpoints (GitHub API, nad.fun API, Monad RPC)
• The skill operates entirely within your local environment

.env File Generation

• The Install Wizard generates a .env file on your local machine
• This file is never committed to version control (gitignored)
• You can review and edit it at any time

Credential Scope

• GITHUB_TOKEN: Used only for GitHub API calls to read public repository data
• PRIVATE_KEY: Used only for EVM transaction signing (never exposed in plain text)
• BUILDER_ID: Local identifier for A2A protocol
• NAD_FUN_API_KEY: Used only for nad.fun token creation API

Testnet Mode

• Default operation is on testnet for safety
• Mainnet requires explicit configuration
• Always review transactions before signing

The AI agent skill for memecoin launches on nad.fun. Analyze GitHub projects, generate token metadata, and launch directly on nad.fun bonding curves.

What is TokenBroker?

TokenBroker is a complete memecoin launch solution for AI agents:

1. Analyzes GitHub projects to identify meme-worthy projects
2. Generates token names, tickers, descriptions, and marketing content
3. Launches tokens on nad.fun (image, metadata, salt, deploy)
4. Promotes launches with X/Telegram/Discord content

When to Use This Skill

TokenBroker Handles

• GitHub repository analysis and scoring
• Token identity generation (name, ticker, description)
• Meme-style image generation
• Nad.fun API integration (upload, salt mining)
• Marketing content creation (X threads, Telegram, Discord)
• Full launch orchestration

Not Included

• Wallet private key management (handled by host)
• On-chain transactions beyond nad.fun bonding curves

Architecture (tokenbroker/src/generators/)

generators/
├── identity.ts     # Token name, ticker, description generation
├── reasoning.ts    # Investment thesis, narrative creation
├── promo.ts        # X threads, Telegram, Discord content
├── nadfun.ts       # Nad.fun API: upload image/metadata, mine salt
└── index.ts        # Pipeline orchestrator (generateAll)

Quick Start for Agents

import { generateAll, prepareLaunch } from './generators/index.js';

// 1. Analyze repo and generate all launch assets
const assets = await generateAll({
  repoAnalysis: await analyzeGitHubRepo('https://github.com/user/project')
});

console.log('Token name:', assets.identity.name);
console.log('Ticker:', assets.identity.ticker);
console.log('X Thread:', assets.promo.xThread.tweets);

// 2. Prepare launch on nad.fun (API calls only)
const prepared = await prepareLaunch(assets.identity, 'mainnet');
// -> Returns: { imageUri, metadataUri, salt, saltAddress }

// 3. Deploy on-chain (requires ethers + private key)
// Use deploy.ts module with wallet for on-chain execution

Generator Functions

generateIdentity(input)

Analyzes repo and generates token identity:

{
  name: "SWAPPRO",
  ticker: "SWAP", 
  tagline: "The next generation DeFi protocol",
  description: "Full token description...",
  nameReasoning: "How the name was derived"
}

generateReasoning(input)

Creates investment thesis and narrative:

{
  investmentThesis: "Why this token should exist...",
  problemStatement: "The problem being solved",
  solution: "The proposed solution",
  marketOpportunity: "Market size and opportunity",
  competitiveAdvantage: "Why this wins",
  tokenUtilityRationale: "Token value proposition",
  vision: "Long-term vision"
}

generatePromo(input)

Generates marketing content:

{
  xThread: { title, tweets: [...], hashtags, mentions },
  telegramPost: { title, content, hasButton, buttonText, buttonUrl },
  discordAnnouncement: { title, content, hasEmbed, embedColor, embedFields },
  tagline: "Marketing tagline",
  elevatorPitch: "One-liner pitch"
}

prepareLaunch(identity, network)

Prepares token for nad.fun launch (API calls):

{
  imageUri: "ipfs://...",
  metadataUri: "ipfs://...", 
  salt: "0x...",
  saltAddress: "0x..."
}

Nad.fun Integration

TokenBroker integrates directly with nad.fun API:

Network Configuration

Install

npm install

Configuration

# Network (testnet | mainnet)
NETWORK=mainnet

# GitHub (optional - for repo analysis)
GITHUB_TOKEN=ghp_...

For On-Chain Deployment

TokenBroker prepares all launch data. For actual on-chain deployment:

npm install ethers

Then use with a wallet:

import { prepareLaunch } from './generators/nadfun.js';
import { ethers } from 'ethers';

const prepared = await prepareLaunch(identity, 'mainnet');

// Deploy with wallet
const wallet = new ethers.Wallet(privateKey, provider);
const router = new ethers.Contract(BONDING_CURVE_ROUTER, abi, wallet);
await router.create(tokenParams, fee, toll, tradingAmt, { value: deployFee });

Built for the agentic future. 🦞