@intentsolutionsio/token-launch-tracker 1.0.0

package/skills/skill-adapter/references/best-practices.md

@@ -0,0 +1,69 @@
+# Skill Best Practices
+
+Guidelines for optimal skill usage and development.
+
+## For Users
+
+### Activation Best Practices
+
+1. **Use Clear Trigger Phrases**
+   - Match phrases from skill description
+   - Be specific about intent
+   - Provide necessary context
+
+2. **Provide Sufficient Context**
+   - Include relevant file paths
+   - Specify scope of analysis
+   - Mention any constraints
+
+3. **Understand Tool Permissions**
+   - Check allowed-tools in frontmatter
+   - Know what the skill can/cannot do
+   - Request appropriate actions
+
+### Workflow Optimization
+
+- Start with simple requests
+- Build up to complex workflows
+- Verify each step before proceeding
+- Use skill consistently for related tasks
+
+## For Developers
+
+### Skill Development Guidelines
+
+1. **Clear Descriptions**
+   - Include explicit trigger phrases
+   - Document all capabilities
+   - Specify limitations
+
+2. **Proper Tool Permissions**
+   - Use minimal necessary tools
+   - Document security implications
+   - Test with restricted tools
+
+3. **Comprehensive Documentation**
+   - Provide usage examples
+   - Document common pitfalls
+   - Include troubleshooting guide
+
+### Maintenance
+
+- Keep version updated
+- Test after tool updates
+- Monitor user feedback
+- Iterate on descriptions
+
+## Performance Tips
+
+- Scope skills to specific domains
+- Avoid overlapping trigger phrases
+- Keep descriptions under 1024 chars
+- Test activation reliability
+
+## Security Considerations
+
+- Never include secrets in skill files
+- Validate all inputs
+- Use read-only tools when possible
+- Document security requirements

package/skills/skill-adapter/references/examples.md

@@ -0,0 +1,73 @@
+# Skill Usage Examples
+
+This document provides practical examples of how to use this skill effectively.
+
+## Basic Usage
+
+### Example 1: Simple Activation
+
+**User Request:**
+```
+[Describe trigger phrase here]
+```
+
+**Skill Response:**
+1. Analyzes the request
+2. Performs the required action
+3. Returns results
+
+### Example 2: Complex Workflow
+
+**User Request:**
+```
+[Describe complex scenario]
+```
+
+**Workflow:**
+1. Step 1: Initial analysis
+2. Step 2: Data processing
+3. Step 3: Result generation
+4. Step 4: Validation
+
+## Advanced Patterns
+
+### Pattern 1: Chaining Operations
+
+Combine this skill with other tools:
+```
+Step 1: Use this skill for [purpose]
+Step 2: Chain with [other tool]
+Step 3: Finalize with [action]
+```
+
+### Pattern 2: Error Handling
+
+If issues occur:
+- Check trigger phrase matches
+- Verify context is available
+- Review allowed-tools permissions
+
+## Tips & Best Practices
+
+- ✅ Be specific with trigger phrases
+- ✅ Provide necessary context
+- ✅ Check tool permissions match needs
+- ❌ Avoid vague requests
+- ❌ Don't mix unrelated tasks
+
+## Common Issues
+
+**Issue:** Skill doesn't activate
+**Solution:** Use exact trigger phrases from description
+
+**Issue:** Unexpected results
+**Solution:** Check input format and context
+
+## See Also
+
+- Main SKILL.md for full documentation
+- scripts/ for automation helpers
+- assets/ for configuration examples
+
+---
+*[Tons of Skills](https://tonsofskills.com) by [Intent Solutions](https://intentsolutions.io) | [jeremylongshore.com](https://jeremylongshore.com)*

package/skills/skill-adapter/scripts/README.md

@@ -0,0 +1,8 @@
+# Scripts
+
+Bundled resources for token-launch-tracker skill
+
+- [ ] contract_security_analysis.py: Script to perform static analysis and vulnerability detection on smart contracts.
+- [ ] liquidity_lock_checker.py: Script to verify LP locks and track liquidity changes.
+- [ ] social_verification.py: Script to assess team legitimacy and community presence.
+- [ ] risk_scoring.py: Script to calculate a composite risk score for a token.

package/skills/skill-adapter/scripts/helper-template.sh

@@ -0,0 +1,42 @@
+#!/bin/bash
+# Helper script template for skill automation
+# Customize this for your skill's specific needs
+
+set -e
+
+function show_usage() {
+    echo "Usage: $0 [options]"
+    echo ""
+    echo "Options:"
+    echo "  -h, --help     Show this help message"
+    echo "  -v, --verbose  Enable verbose output"
+    echo ""
+}
+
+# Parse arguments
+VERBOSE=false
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -h|--help)
+            show_usage
+            exit 0
+            ;;
+        -v|--verbose)
+            VERBOSE=true
+            shift
+            ;;
+        *)
+            echo "Unknown option: $1"
+            show_usage
+            exit 1
+            ;;
+    esac
+done
+
+# Your skill logic here
+if [ "$VERBOSE" = true ]; then
+    echo "Running skill automation..."
+fi
+
+echo "✅ Complete"

package/skills/skill-adapter/scripts/validation.sh

@@ -0,0 +1,32 @@
+#!/bin/bash
+# Skill validation helper
+# Validates skill activation and functionality
+
+set -e
+
+echo "🔍 Validating skill..."
+
+# Check if SKILL.md exists
+if [ ! -f "../SKILL.md" ]; then
+    echo "❌ Error: SKILL.md not found"
+    exit 1
+fi
+
+# Validate frontmatter
+if ! grep -q "^---$" "../SKILL.md"; then
+    echo "❌ Error: No frontmatter found"
+    exit 1
+fi
+
+# Check required fields
+if ! grep -q "^name:" "../SKILL.md"; then
+    echo "❌ Error: Missing 'name' field"
+    exit 1
+fi
+
+if ! grep -q "^description:" "../SKILL.md"; then
+    echo "❌ Error: Missing 'description' field"
+    exit 1
+fi
+
+echo "✅ Skill validation passed"

package/skills/tracking-token-launches/ARD.md

@@ -0,0 +1,183 @@
+# ARD: Token Launch Tracker
+
+> Part of [Tons of Skills](https://tonsofskills.com) by [Intent Solutions](https://intentsolutions.io) | [jeremylongshore.com](https://jeremylongshore.com)
+
+## Architecture Pattern
+
+**Event Streaming Pattern** - Python CLI that monitors blockchain events and aggregates data from multiple sources.
+
+## Workflow
+
+```
+Event Detection → Data Enrichment → Risk Analysis → Display
+       ↓                ↓                ↓            ↓
+  RPC/Websocket    Token Info        Contract      Table/Alert
+                                     Analysis
+```
+
+## Data Flow
+
+```
+Input: Chain selection + filters (time, DEX, liquidity)
+          ↓
+Monitor: PairCreated events from DEX factories
+          ↓
+Enrich: Fetch token metadata (name, symbol, supply)
+          ↓
+Analyze: Check contract for red flags
+          ↓
+Filter: Apply user criteria (min liquidity, etc.)
+          ↓
+Output: Formatted launch list with risk indicators
+```
+
+## Directory Structure
+
+```
+skills/tracking-token-launches/
+├── PRD.md                    # Product requirements
+├── ARD.md                    # Architecture document
+├── SKILL.md                  # Agent instructions
+├── scripts/
+│   ├── launch_tracker.py     # Main CLI entry point
+│   ├── event_monitor.py      # Blockchain event listener
+│   ├── token_analyzer.py     # Token contract analysis
+│   ├── dex_sources.py        # DEX factory addresses
+│   └── formatters.py         # Output formatting
+├── references/
+│   ├── errors.md             # Error handling guide
+│   └── examples.md           # Usage examples
+└── config/
+    └── settings.yaml         # Default configuration
+```
+
+## API Integration
+
+### Ethereum RPC (eth_getLogs)
+- **Events**: PairCreated, Transfer, Mint
+- **Data**: New pair address, token addresses, reserves
+
+### DexScreener API
+- **Endpoint**: `https://api.dexscreener.com/latest/dex/tokens/{address}`
+- **Data**: Price, liquidity, volume, pair info
+
+### GeckoTerminal API
+- **Endpoint**: `https://api.geckoterminal.com/api/v2/`
+- **Data**: New pools, token info, trading data
+
+## Component Design
+
+### event_monitor.py
+```python
+class EventMonitor:
+    def get_recent_pairs(chain, dex, hours) -> List[PairCreated]
+    def stream_new_pairs(chain, callback) -> None
+    def get_liquidity_adds(pair_address) -> List[LiquidityEvent]
+```
+
+### token_analyzer.py
+```python
+class TokenAnalyzer:
+    def get_token_info(address) -> TokenInfo
+    def check_contract(address) -> ContractAnalysis
+    def get_holders(address, top_n) -> List[Holder]
+    def detect_honeypot(address) -> HoneypotResult
+```
+
+### dex_sources.py
+```python
+# DEX factory addresses per chain
+DEX_FACTORIES = {
+    "ethereum": {
+        "uniswap_v2": "0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f",
+        "uniswap_v3": "0x1F98431c8aD98523631AE4a59f267346ea31F984",
+        "sushiswap": "0xC0AEe478e3658e2610c5F7A4A2E1777cE9e4f2Ac",
+    },
+    # ... more chains
+}
+```
+
+## Data Structures
+
+### PairCreated Event
+```python
+@dataclass
+class PairCreated:
+    block_number: int
+    timestamp: int
+    pair_address: str
+    token0: str
+    token1: str
+    dex: str
+    chain: str
+```
+
+### TokenInfo
+```python
+@dataclass
+class TokenInfo:
+    address: str
+    name: str
+    symbol: str
+    decimals: int
+    total_supply: int
+    owner: str
+    is_verified: bool
+```
+
+### ContractAnalysis
+```python
+@dataclass
+class ContractAnalysis:
+    has_mint_function: bool
+    has_blacklist: bool
+    is_proxy: bool
+    ownership_renounced: bool
+    liquidity_locked: bool
+    risk_score: int  # 0-100
+```
+
+## Risk Indicators
+
+| Indicator | Risk Level | Detection |
+|-----------|------------|-----------|
+| Mint function | High | Bytecode analysis |
+| Blacklist/whitelist | Medium | Function signature |
+| Not verified | Medium | Block explorer API |
+| Proxy contract | Medium | Implementation check |
+| Owner not renounced | Low | owner() call |
+| Low initial liquidity | Warning | Reserve check |
+| Few holders | Warning | Holder count |
+
+## Supported Chains
+
+| Chain | Chain ID | DEXes |
+|-------|----------|-------|
+| Ethereum | 1 | Uniswap V2/V3, Sushiswap |
+| BSC | 56 | PancakeSwap V2/V3 |
+| Arbitrum | 42161 | Camelot, Uniswap |
+| Base | 8453 | Aerodrome, Uniswap |
+| Polygon | 137 | QuickSwap, Uniswap |
+
+## Error Handling Strategy
+
+| Error | Handling |
+|-------|----------|
+| RPC connection failed | Fallback to backup RPC |
+| Rate limited | Exponential backoff |
+| Contract not verified | Show warning, limited analysis |
+| Invalid chain | Return supported chains list |
+
+## Performance Considerations
+
+- Cache token info (24h TTL)
+- Batch RPC calls when possible
+- Use websockets for real-time monitoring
+- Limit historical scan to 24h default
+
+## Security
+
+- No wallet connections
+- Read-only operations
+- API keys in environment variables
+- No transaction signing

package/skills/tracking-token-launches/PRD.md

@@ -0,0 +1,66 @@
+# PRD: Token Launch Tracker
+
+## Summary
+
+**One-liner**: Track new token launches, liquidity additions, and upcoming IDO/IEO events across chains.
+
+**Domain**: Cryptocurrency / DeFi / Token Launches
+
+**Users**: Traders, Investors, Researchers, Degens
+
+## Problem Statement
+
+New token launches happen constantly across multiple chains and DEXes. Traders miss opportunities because they can't track all launches in real-time. Manual monitoring is time-consuming and unreliable. Existing tools are scattered across different platforms.
+
+## User Stories
+
+1. **As a trader**, I want to see new tokens that just added liquidity, so that I can evaluate early entry opportunities.
+
+2. **As an investor**, I want to track upcoming IDO/IEO launches, so that I can plan participation in promising projects.
+
+3. **As a researcher**, I want to analyze token launch patterns, so that I can identify trends and red flags.
+
+4. **As a degen**, I want real-time alerts for new token deployments, so that I can assess them quickly.
+
+## Functional Requirements
+
+- **REQ-1**: Detect new token deployments on supported chains
+- **REQ-2**: Track liquidity additions on major DEXes
+- **REQ-3**: Fetch upcoming launches from IDO platforms
+- **REQ-4**: Display token contract info (name, symbol, supply)
+- **REQ-5**: Show initial liquidity amount and trading pair
+- **REQ-6**: Analyze contract for common rug pull indicators
+- **REQ-7**: Support multiple chains (Ethereum, BSC, Base, Arbitrum)
+- **REQ-8**: Provide filtering by chain, DEX, and time window
+
+## Data Sources
+
+### On-Chain Detection
+- Factory contract events (PairCreated)
+- Token deployment transactions
+- Liquidity mint events
+
+### IDO/IEO Platforms
+- CoinList
+- Pinksale
+- DxSale
+- Unicrypt
+
+### Aggregators
+- DEXTools
+- DexScreener
+- GeckoTerminal
+
+## Success Metrics
+
+- Detect liquidity additions within 1 block
+- List upcoming IDOs with correct dates
+- Flag suspicious contracts accurately
+- Support 5+ chains and 10+ DEXes
+
+## Non-Goals
+
+- Automated trading or sniping
+- Financial advice on token quality
+- Price predictions
+- Private sale access

package/skills/tracking-token-launches/SKILL.md

@@ -0,0 +1,161 @@
+---
+name: tracking-token-launches
+description: |
+  Track new token launches across DEXes with risk analysis and contract verification.
+  Use when discovering new token launches, monitoring IDOs, or analyzing token contracts.
+  Trigger with phrases like "track launches", "find new tokens", "new pairs on uniswap",
+  "token risk analysis", or "monitor IDOs".
+
+allowed-tools: Read, Write, Edit, Grep, Glob, Bash(python:*launch_tracker*)
+version: 1.0.0
+author: Jeremy Longshore <jeremy@intentsolutions.io>
+license: MIT
+compatible-with: claude-code, codex, openclaw
+tags: [crypto, monitoring, tracking-token]
+---
+# Token Launch Tracker
+
+## Overview
+
+Monitor new token launches across decentralized exchanges. Detect PairCreated events from DEX factory contracts, fetch token metadata, and analyze contracts for risk indicators like mint functions, blacklists, proxy patterns, and ownership status.
+
+## Prerequisites
+
+Before using this skill, ensure you have:
+- Python 3.8+ with `requests` library
+- RPC endpoint access (public endpoints work for basic usage)
+- Optional: Etherscan API key for contract verification checks
+- Optional: Custom RPC URLs for higher rate limits
+
+## Commands
+
+### recent - Show Recent Launches
+```bash
+python launch_tracker.py recent --chain ethereum --hours 24
+python launch_tracker.py recent --chain base --analyze --limit 20
+python launch_tracker.py recent --chain bsc --dex "PancakeSwap V2" -f json
+```
+
+Options:
+- `--chain, -c`: Chain to scan (ethereum, bsc, arbitrum, base, polygon)
+- `--hours, -H`: Hours to look back (default: 24)
+- `--dex, -d`: Filter by DEX name
+- `--limit, -l`: Maximum results (default: 50)
+- `--analyze, -a`: Include token and contract analysis
+- `--rpc-url`: Custom RPC URL
+
+### detail - Token Details
+```bash
+python launch_tracker.py detail --address 0x... --chain ethereum
+```
+
+Options:
+- `--address, -a`: Token contract address (required)
+- `--chain, -c`: Chain (default: ethereum)
+- `--pair, -p`: Pair address (optional)
+- `--etherscan-key`: API key for verification check
+
+### risk - Risk Analysis
+```bash
+python launch_tracker.py risk --address 0x... --chain base
+```
+
+Analyzes contract for risk indicators:
+- Mint function (HIGH risk)
+- Proxy contract (MEDIUM risk)
+- Not verified (MEDIUM risk)
+- Blacklist functionality (MEDIUM risk)
+- Active owner (LOW risk)
+
+### summary - Launch Statistics
+```bash
+python launch_tracker.py summary --hours 24
+python launch_tracker.py summary --chains ethereum,base,arbitrum
+```
+
+### dexes - List DEXes
+```bash
+python launch_tracker.py dexes --chain bsc
+```
+
+### chains - List Chains
+```bash
+python launch_tracker.py chains
+```
+
+## Instructions
+
+1. **Check recent launches** on a specific chain:
+   ```bash
+   cd ${CLAUDE_SKILL_DIR}/scripts
+   python launch_tracker.py recent --chain ethereum --hours 6
+   ```
+
+2. **Get detailed token info** for a specific address:
+   ```bash
+   python launch_tracker.py detail --address 0x6982508145454ce325ddbe47a25d4ec3d2311933 --chain ethereum
+   ```
+
+3. **Analyze token risk** before interaction:
+   ```bash
+   python launch_tracker.py risk --address 0x... --chain base --etherscan-key YOUR_KEY
+   ```
+
+4. **View cross-chain summary**:
+   ```bash
+   python launch_tracker.py summary --hours 24
+   ```
+
+5. **Export to JSON** for programmatic use:
+   ```bash
+   python launch_tracker.py -f json recent --chain ethereum --analyze > launches.json
+   ```
+
+## Supported Chains
+
+| Chain | DEXes | Block Time |
+|-------|-------|------------|
+| Ethereum | Uniswap V2/V3, SushiSwap | 12s |
+| BSC | PancakeSwap V2/V3 | 3s |
+| Arbitrum | Uniswap V3, Camelot, SushiSwap | 0.25s |
+| Base | Uniswap V3, Aerodrome | 2s |
+| Polygon | Uniswap V3, QuickSwap, SushiSwap | 2s |
+
+## Risk Indicators
+
+| Indicator | Severity | Description |
+|-----------|----------|-------------|
+| Mint function | HIGH | Contract can mint new tokens |
+| Proxy contract | MEDIUM | Implementation can be changed |
+| Not verified | MEDIUM | Source code not public |
+| Blacklist/whitelist | MEDIUM | Can restrict transfers |
+| Active owner | LOW | Ownership not renounced |
+| Small bytecode | INFO | Might be minimal/proxy |
+
+## Output
+
+- **Table format**: Formatted ASCII tables with token data
+- **JSON format**: Structured data for programmatic use
+- **Risk scores**: 0-100 scale (higher = riskier)
+- **Links**: Explorer and DEXScreener URLs
+
+## Error Handling
+
+See `${CLAUDE_SKILL_DIR}/references/errors.md` for comprehensive error handling including:
+- RPC connection issues and fallback chain
+- Rate limiting and backoff strategies
+- Contract analysis edge cases
+
+## Examples
+
+See `${CLAUDE_SKILL_DIR}/references/examples.md` for detailed examples including:
+- Finding high-risk tokens
+- Multi-chain monitoring scripts
+- Python integration
+
+## Resources
+
+- [Uniswap V2 Factory](https://docs.uniswap.org/contracts/v2/reference/smart-contracts/factory)
+- [PancakeSwap Factory](https://docs.pancakeswap.finance/developers/smart-contracts)
+- [DEXScreener](https://dexscreener.com/) - Real-time pair data
+- [Etherscan API](https://docs.etherscan.io/) - Contract verification