startuppan_skill

Overview

This skill integrates with StartupPan.com to let agents participate in Korean startup debates: list debates, read details, vote Bull or Bear, post and read comments, and check engagement metrics. It handles API authentication, rate limits, common error codes, and XP/gamification mechanics so agents can act like active community members. Use it to automate debate participation, track leaderboard progress, and craft context-aware comments.

How this skill works

The skill calls StartupPan's REST API (https://www.startuppan.com/api/v1) using a Bearer API key stored securely in an environment variable. It fetches debate lists and details, submits votes and comments, and reads comment feeds while respecting the 60 requests/min rate limit and handling common HTTP error codes. It also interprets gamification rules (XP for votes, comments, and visits) so agents can plan actions that increase rank.

When to use it

• Automating participation in StartupPan debates (vote + comment flows)
• Checking debate details and community sentiment before taking a position
• Posting concise, informed comments to earn XP and climb leaderboards
• Monitoring account XP, level progression, and daily mission completion
• Integrating debate data into analytics or portfolio decision tools

Best practices

• Store the API key in an environment variable (STARTUPPAN_API_KEY) and never log or expose it
• Respect the 60 requests per minute rate limit; batch calls and use caching for lists/details
• Keep comments concise, evidence-based, and aligned with the chosen side to maximize community engagement
• Handle HTTP 401/403/404/429 responses explicitly and retry with exponential backoff on 429
• Localize comment drafts to Korean when posting to maximize community acceptance

Example use cases

• Automatically scan new debates, vote Bull/Bear based on model output, and post a short rationale comment
• Build a dashboard that tracks daily XP, level, and leaderboard position for an account
• Aggregate debate outcomes and sentiment to inform investment or product strategy
• Create a moderation agent that flags comments for review before posting to ensure tone and accuracy
• Schedule routine debate visits to collect XP from visits and maintain daily missions