{
  "markdown": "# bl1nk Skill Builder - AI Skill Development IDE\n\n> 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.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.8-blue)](https://www.typescriptlang.org/)\n[![Electron](https://img.shields.io/badge/Electron-38.2-47848F)](https://www.electronjs.org/)\n[![Security](https://img.shields.io/badge/Security-Hardened-green)](./docs/SECURITY.md)\n\n## 🎯 Overview\n\nbl1nk 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`)**.\n\n**Think \"VS Code but for AI development\"**\n\n### Key Statistics (Design Specification)\n\n- ✅ **68 Total Endpoints** (Designed API)\n- ✅ **9 Major Modules** (Project, Skill, Agent, Provider, etc.)\n- ✅ **6 Agent Categories** (501 pre-built agents)\n- ✅ **15 Skill Categories**\n- ✅ **6 LLM Providers** integrated\n\n---\n\n## 📚 Design Documentation & Specification\n\nThis project is fully documented with detailed design specifications.\n\n| Document | Description | Target Audience |\n| :--- | :--- | :--- |\n| **SKILL.md** | Platform overview, core modules, skill workflows, and use cases. | Designers, Product Managers |\n| **API_SPECIFICATION.yaml** | Complete REST API specification in OpenAPI 3.1 format (68 endpoints). | API Developers |\n| **ENDPOINTS_SUMMARY.md** | Quick lookup table for all 68 endpoints, organized by module. | API Developers |\n| **MODULES_ARCHITECTURE.md** | Complete architecture for all 9 modules, including database schema and data flow. | Backend Engineers |\n| **IMPLEMENTATION_GUIDE.md** | Developer guide, quick start, API development workflow, and testing strategy. | Backend Engineers |\n\n---\n\n## 🛠️ Technology Stack\n\n| Component | Technology | Details |\n| :--- | :--- | :--- |\n| **Monorepo** | pnpm | Efficient dependency management |\n| **Frontend (IDE)** | Electron 38.2, Next.js 15, React 19 | Desktop application framework and UI |\n| **Backend (API)** | Express.js / Hono, Node.js 20+ | High-performance API server |\n| **Database** | SQLite (Phase 1), PostgreSQL (Phase 2) | Persistence layer |\n| **ORM** | Drizzle ORM | Type-safe database access |\n| **Testing** | Jest, Playwright, SuperTest | Unit, E2E, and API testing |\n| **AI Integration** | AWS Bedrock, OpenAI, Anthropic, Google, OpenRouter | Multi-provider LLM support |\n\n---\n\n## 🚀 Quick Start (Development)\n\n### Prerequisites\n- Node.js >= 20.0.0\n- pnpm (latest version)\n- Git\n\n### Installation\n\n```bash\n# Clone repository\ngit clone https://github.com/bl1nk-org/bl1nk-skill-platform.git\ncd bl1nk-skill-platform\n\n# Install dependencies (Monorepo)\npnpm install\n\n# Copy environment variables\ncp .env.example .env\n\n# Start development (Client and Server)\npnpm dev\n```\n\n### Available Commands\n\n| Command | Description |\n| :--- | :--- |\n| `pnpm dev` | Start all services (Client IDE and Server API) |\n| `pnpm build` | Build all packages |\n| `pnpm test:e2e` | Run End-to-End tests (Playwright) |\n| `pnpm test:unit` | Run unit tests |\n| `pnpm validate` | Run all checks (format, lint, type-check) |\n| `pnpm validate:agents` | Validate 501 agent configurations |\n| `pnpm health` | Project health check |\n\n---\n\n## 🔒 Security Features\n\nThe platform is designed with security in mind, especially for credential management:\n\n- ✅ **AES-256-GCM** encryption for API credentials\n- ✅ **JWT** authentication for API access\n- ✅ **Input validation** with Zod schemas\n- ✅ **Rate limiting** on sensitive endpoints\n- ✅ **Context isolation** in the Electron client\n- ✅ **Path traversal** and **Symlink loop** protection\n\nSee [SECURITY.md](./docs/SECURITY.md) for detailed guidelines.\n\n---\n\n## 🗺️ Implementation Roadmap\n\n| Phase | Status | Key Milestones |\n| :--- | :--- | :--- |\n| **Phase 1** | ✅ Complete | Core skill management, 501 agent library, Multi-provider AI, SQLite + Drizzle, Electron packaging. |\n| **Phase 2** | 🔄 Current | REST API v1 with OpenAPI spec, Comprehensive design documentation, **PostgreSQL + Redis migration**, **CI/CD automation**, Cloud synchronization. |\n| **Phase 3** | 📅 Planned | Multi-user authentication, Advanced skill organization, Observability dashboard, Automated backups. |\n| **Phase 4** | 📅 Future | Cloud sync for skills, Skill marketplace, Advanced access controls, Enterprise features. |\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup, code standards, and the pull request process.\n\n## 📄 License\n\nMIT License - see [LICENSE](./LICENSE) file for details.\n\n**Made with ❤️ by the bl1nk team**\n",
  "bytes": 4837,
  "sha": "380e828d2a097ef924d4ab5cd3a7b83d8eb6bbaf589ac10c6826f099a13665d8",
  "repo_slug": "billlzzz18/bl1nk-skill-platform",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_billlzzz18_bl1nk_skill_platform_c9a25721/readme"
}