Skip to content

adraalabs/skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Adraa Skills

Open-source skills for Adraa — the AI-powered Discord & Telegram bot. Each skill teaches the AI how to build a feature correctly.

What are skills?

Skills are markdown instructions that teach the Adraa bot how to compose features from atoms (commands, triggers, data store). They're not rigid configs — the AI adapts each skill to your server's needs while following proven patterns.

Think of it like skills.sh but for Discord/Telegram bots.

Available Skills

Skill Platforms Category Description
giveaway Discord, Telegram engagement Timed giveaways with reaction entries and live count
leveling Discord, Telegram engagement XP, levels, rank cards, leaderboard
welcome Discord, Telegram community Welcome messages, auto-role, goodbye
ticket-system Discord, Telegram moderation Support tickets with modal forms and private channels
starboard Discord engagement Pin popular messages to a highlight channel
economy Discord, Telegram economy Coins, balance, pay, daily rewards
invite-tracker Discord community Track who invited whom, invite leaderboard
auto-roles Discord community Auto-assign or self-pick roles
polls Discord, Telegram engagement Polls with buttons and live vote counts
birthday Discord, Telegram community Birthday tracking and announcements

How to use

Just ask your Adraa bot:

"@Adraa set up a giveaway system"

The bot searches for a matching skill, reads the instructions, and builds it for your server — adapting to your channels, roles, and preferences.

Browse all skills at marketplace.adraa.ai.

How it works

You: "@Adraa create a leveling system"
         │
         ▼
Bot: search_skills("leveling")
         │
         ▼
Fetches index.json (one request, lists all skills)
         │
         ▼
Found! → get_skill("github:leveling")
         │
         ▼
Reads leveling/skill.md instructions
         │
         ▼
Builds: trigger (xp_gain) + /rank + /top
         │
         ▼
Done — adapted to your server

Why index.json?

Skills are discovered via a single index.json file — not by listing directories. This means:

  • One fetch to search all skills (no N+1 API calls)
  • No rate limits — it's a static file on GitHub CDN
  • Scales to thousands of skills
  • Instant search — bot filters locally after one fetch

The full skill.md is only fetched when the AI needs to actually build the feature.

index.json is auto-generated by a GitHub Action on every push — you never edit it manually.

Contributing

  1. Fork this repo
  2. Create a folder: my-skill/skill.md
  3. Follow the format below
  4. Submit a PR — index.json updates automatically on merge

Skill format

---
name: my-skill
description: What this skill does. Use when asked for...
category: engagement | moderation | economy | community | fun | utility
platforms: [discord, telegram]
version: 1
author: your-name
---

## Setup

Step by step, what commands and triggers to create.

## Key rules

Gotchas and critical patterns the AI must follow.

Key rules for writing good skills

  • Be specific about placeholders: {user} in a reaction trigger = the reactor, not the message author
  • Warn about common mistakes: "always filter by emoji", "use embed not content in edit_message"
  • Include the data pattern: what keys to store, what format
  • Note platform differences: if something only works on Discord, say so
  • Keep it concise: the AI reads this on every build — shorter = faster

License

MIT

About

Open-source skills for the Adraa Discord bot

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors