bl1nk Skill Builder - AI Skill Development IDE

AI-powered IDE for creating, managing, and testing bl1nk AI skills, agents, and MCP tools. This repository contains the complete platform code and design specification.

🎯 Overview

bl1nk Skill Builder is a comprehensive desktop IDE specifically designed for AI development. It is built as a Monorepo using pnpm and consists of a Desktop Client (apps/client) and a Backend Server (apps/server).

Think "VS Code but for AI development"

Key Statistics (Design Specification)

✅ 68 Total Endpoints (Designed API)
✅ 9 Major Modules (Project, Skill, Agent, Provider, etc.)
✅ 6 Agent Categories (501 pre-built agents)
✅ 15 Skill Categories
✅ 6 LLM Providers integrated

📚 Design Documentation & Specification

This project is fully documented with detailed design specifications.

Document	Description	Target Audience
SKILL.md	Platform overview, core modules, skill workflows, and use cases.	Designers, Product Managers
API_SPECIFICATION.yaml	Complete REST API specification in OpenAPI 3.1 format (68 endpoints).	API Developers
ENDPOINTS_SUMMARY.md	Quick lookup table for all 68 endpoints, organized by module.	API Developers
MODULES_ARCHITECTURE.md	Complete architecture for all 9 modules, including database schema and data flow.	Backend Engineers
IMPLEMENTATION_GUIDE.md	Developer guide, quick start, API development workflow, and testing strategy.	Backend Engineers

🛠️ Technology Stack

Component	Technology	Details
Monorepo	pnpm	Efficient dependency management
Frontend (IDE)	Electron 38.2, Next.js 15, React 19	Desktop application framework and UI
Backend (API)	Express.js / Hono, Node.js 20+	High-performance API server
Database	SQLite (Phase 1), PostgreSQL (Phase 2)	Persistence layer
ORM	Drizzle ORM	Type-safe database access
Testing	Jest, Playwright, SuperTest	Unit, E2E, and API testing
AI Integration	AWS Bedrock, OpenAI, Anthropic, Google, OpenRouter	Multi-provider LLM support

🚀 Quick Start (Development)

Prerequisites

Node.js >= 20.0.0
pnpm (latest version)
Git

Installation

# Clone repository
git clone https://github.com/bl1nk-org/bl1nk-skill-platform.git
cd bl1nk-skill-platform

# Install dependencies (Monorepo)
pnpm install

# Copy environment variables
cp .env.example .env

# Start development (Client and Server)
pnpm dev

Available Commands

Command	Description
`pnpm dev`	Start all services (Client IDE and Server API)
`pnpm build`	Build all packages
`pnpm test:e2e`	Run End-to-End tests (Playwright)
`pnpm test:unit`	Run unit tests
`pnpm validate`	Run all checks (format, lint, type-check)
`pnpm validate:agents`	Validate 501 agent configurations
`pnpm health`	Project health check

🔒 Security Features

The platform is designed with security in mind, especially for credential management:

✅ AES-256-GCM encryption for API credentials
✅ JWT authentication for API access
✅ Input validation with Zod schemas
✅ Rate limiting on sensitive endpoints
✅ Context isolation in the Electron client
✅ Path traversal and Symlink loop protection

See SECURITY.md for detailed guidelines.

🗺️ Implementation Roadmap

Phase	Status	Key Milestones
Phase 1	✅ Complete	Core skill management, 501 agent library, Multi-provider AI, SQLite + Drizzle, Electron packaging.
Phase 2	🔄 Current	REST API v1 with OpenAPI spec, Comprehensive design documentation, PostgreSQL + Redis migration, CI/CD automation, Cloud synchronization.
Phase 3	📅 Planned	Multi-user authentication, Advanced skill organization, Observability dashboard, Automated backups.
Phase 4	📅 Future	Cloud sync for skills, Skill marketplace, Advanced access controls, Enterprise features.

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for development setup, code standards, and the pull request process.

📄 License

MIT License - see LICENSE file for details.

Made with ❤️ by the bl1nk team