This is a staging repo. for the AIBTC x BITFLOW DeFi Skill Competition. Submit your skill here via PR. Approved skills get pushed to the official AIBTC skills registry.
$100/day in BTC to the best DeFi skill submitted. 30 days. On-chain proof required. Best skill each day wins.
Bonus: +$1,000 BTC pool for skills that directly integrate HODLMM.
- Announce: Monday, March 23
- Submissions open: Wednesday, March 25
- Prize paid in: BTC, automatically on approval
Submit in any of these categories — broad by design:
- Trading — swaps, arb detection, price impact, execution logic
- Yield — LP management, fee harvesting, yield dashboards, rebalance strategies
- Infrastructure — escrow, oracles, agent-to-agent comms, data freshness monitors
- Signals — market signals, risk alerts, portfolio monitoring, trade rationale
skills/
└── your-skill-name/
├── SKILL.md
├── AGENT.md
└── your-skill-name.ts
Follow the SKILL_TEMPLATE.md exactly — the AIBTC validator will reject submissions with missing or malformed frontmatter.
bun run scripts/validate-frontmatter.ts
bun run scripts/generate-manifest.ts
bun run skills/your-skill-name/your-skill-name.ts doctorAttach the output of these commands in your PR description.
Use the PR template — it auto-fills when you open one. Required fields:
- What the skill does
- On-chain proof (tx link or live output) — no proof = not reviewed
- Whether it integrates HODLMM (eligible for +$1K bonus pool)
- Smoke test results
PRs are reviewed by the BFF Army council (humans + a Bitflow agent). Expect feedback within 24 hours. Fix requested changes fast — reviewer responsiveness is part of the process.
Daily winners are announced on @Bitflow and listed at bff.army/agents.txt. Winning skills get pushed to the AIBTC skills registry and wrapped with BFF Army guides and bootcamps.
| Criteria | What we're looking for |
|---|---|
| Reliability | Idempotent reruns, safe defaults, handles errors explicitly |
| Security | No secret leakage, clear warnings on writes or fund movements |
| Structure | Valid SKILL.md frontmatter, AGENT.md behavior rules, JSON output contract |
| Proof | On-chain tx or live command output proving it works end-to-end |
| HODLMM integration | Eligible for the +$1K bonus pool |
- SKILL_TEMPLATE.md — required format for all submissions
- AIBTC Skills Registry — where approved skills are published
- BFF Army — guides, courses, and bootcamps for winning skills
- bff.army/agents.txt — daily winners and competition updates
- HODLMM — the liquidity infrastructure your skills can plug into
This staging repo feeds into the official AIBTC skills registry. All approved skills are promoted there. To avoid conversion friction during promotion:
Your SKILL.md must use the metadata: nested format — not flat keys. See SKILL_TEMPLATE.md for the exact schema. The most common CI failures:
tagsandrequiresmust be comma-separated quoted strings, not YAML arraysuser-invocablemust be the string"false", not a booleanentrymust be repo-root-relative (e.g.your-skill-name/your-skill-name.ts, notskills/your-skill-name/...)AGENT.mdmust start with YAML frontmatter containingname,skill, anddescription
Use Commander.js for argument parsing. See SKILL_TEMPLATE.md §3 for the pattern.
Registry minimum: { "error": "descriptive message" } for errors. See SKILL_TEMPLATE.md output contract section.
After a skill wins and is pushed to aibtcdev/skills:
- Skill directory moves to repo root (no
skills/prefix) - A row is added to the aibtcdev/skills README.md skills table
bun run manifestregeneratesskills.jsonbun run typecheckmust pass- Commit format:
feat(skill-name): add skill-name skill
For the full target conventions, see aibtcdev/skills CONTRIBUTING.md.
Open an issue or find us in the Bitflow Discord.