Back to the catalog

bl1nk-visual-story-planner

Gemini CLI extension manifest for the Visual Story Planner MCP tools.

Open source Open in the app JSON README (API)

About

Gemini CLI extension manifest for the Visual Story Planner MCP tools.

Details

Kind
Plugins
Topic
AI, RAG & memory
Publisher
billlzzz18
Origin
gemini
Category
ferramentas
Version
0.1.0
Open pull requests
5
Last push
2026-08-13T11:47:52Z
Repository state
ativo
Language
TypeScript
License
MIT
Added
2026-08-30 14:13:39
Updated
2026-08-30 14:13:39
Origin id
billlzzz18/bl1nk-skill-platform

README

# 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.

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.8-blue)](https://www.typescriptlang.org/)
[![Electron](https://img.shields.io/badge/Electron-38.2-47848F)](https://www.electronjs.org/)
[![Security](https://img.shields.io/badge/Security-Hardened-green)](./docs/SECURITY.md)

## 🎯 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

```bash
# 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](./docs/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](./CONTRIBUTING.md) for development setup, code standards, and the pull request process.

## πŸ“„ License

MIT License - see [LICENSE](./LICENSE) file for details.

**Made with ❀️ by the bl1nk team**

More