AGNXI - Agent Skills Directory

AGNXI is a directory of SKILL.md skills for coding assistants like Claude Code, Cursor, Windsurf, and more.

Features

• Skills - Browse SKILL.md files from GitHub
• Categories - Filter by development, testing, documentation, DevOps, and more
• Favorites - Save skills for quick access
• Install Commands - Copy install commands for supported tools
• Sync - Periodic discovery of new skills from GitHub
• Rankings - Sort by stars, forks, and skill count

Tech Stack

Layer	Technology
Framework	Next.js 16 (App Router)
Runtime	Bun
Language	TypeScript 5
Styling	Tailwind CSS 4
Database	PostgreSQL + Drizzle ORM
Auth	Clerk
UI	Base UI + shadcn-style components
AI	Vercel AI SDK + Google Gemini
Cache	Upstash Redis
Background Jobs	Inngest

Quick Start

# Clone repository
git clone https://github.com/doanbactam/kk.git
cd kk

# Install dependencies
bun install

# Setup environment
cp .env.example .env.local
# Edit .env.local with your credentials

# Run database migrations
bun db:push

# Start development server
bun dev

Open http://localhost:3000 to view the app.

Commands

# Development
bun dev              # Start dev server

# Build & Production
bun build            # Production build
bun start            # Start production server

# Code Quality
bun lint             # Run ESLint

# Database
bun db:generate      # Generate migrations
bun db:migrate       # Run migrations
bun db:push          # Push schema to database
bun db:studio        # Open Drizzle Studio

# Scripts
bun db:seed:categories    # Seed category data
bun ping:indexnow         # Submit sitemap to search engines

Project Structure

app/                    # Next.js App Router
  (auth)/               # Auth pages (sign-in, sign-up)
  [owner]/              # Dynamic owner/skill pages
  admin/                # Admin dashboard
  api/                  # API routes
  categories/           # Category listing
  ranking/              # Skills ranking
  skills/               # Skills browsing

components/             # Shared React components
  layouts/              # Layout components
  seo/                  # SEO components
  ui/                   # Base UI components

features/               # Feature-specific components
  examples/             # Example components
  marketing/            # Marketing/landing
  skills/               # Skill cards, grids
  submissions/          # Skill submission

lib/                    # Core utilities
  actions/              # Server actions
  ai/                   # AI integration
  categories/           # Category logic
  db/                   # Database schema & queries
  features/skills/      # Skill discovery & indexing
  hooks/                # React hooks
  inngest/              # Background job functions

config/                 # App configuration
drizzle/                # Database migrations
public/                 # Static assets

Environment Variables

Required environment variables (see .env.example):

# Database
DATABASE_URL=

# Auth (Clerk)
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
CLERK_SECRET_KEY=

# GitHub
GITHUB_TOKEN=

# AI (Google Gemini)
GOOGLE_GENERATIVE_AI_API_KEY=

# Cache (Upstash Redis)
UPSTASH_REDIS_REST_URL=
UPSTASH_REDIS_REST_TOKEN=

# Background Jobs (Inngest)
INNGEST_EVENT_KEY=
INNGEST_SIGNING_KEY=

How It Works

1. Discovery - Scans GitHub for SKILL.md files using Code Search API
2. Indexing - Parses skill metadata (name, description, tools, compatibility)
3. Categorization - Category assignment using Gemini
4. Sync - Scheduled jobs keep the directory updated

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/new-feature)
3. Commit changes (git commit -m 'Add feature')
4. Push to branch (git push origin feature/new-feature)
5. Open a Pull Request

License

MIT (c) doanbactam