yaratai-skill

# SkillForge

<p align="center">
  <strong>Open-source, Docker-ready skill library for AI coding agents.</strong><br>
  Real code. Standard I/O. No database. Just workers.
</p>

<p align="center">
  <a href="#quick-start">Quick Start</a> •
  <a href="#dashboard">Dashboard</a> •
  <a href="#for-ai-agents-cursor-cursor-cursor">AI Agent Setup</a> •
  <a href="#available-skills-51">Skills</a> •
  <a href="#write-your-own-skill">Contribute</a> •
  <a href="#rest-api-reference">API</a>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/python-3.11+-blue?logo=python&logoColor=white" alt="Python 3.11+">
  <img src="https://img.shields.io/badge/docker-ready-2496ED?logo=docker&logoColor=white" alt="Docker Ready">
  <img src="https://img.shields.io/badge/skills-51+-6366f1" alt="51+ Skills">
  <img src="https://img.shields.io/badge/license-Apache%202.0-brightgreen" alt="Apache 2.0">
  <img src="https://img.shields.io/badge/API-REST%20%2B%20Dashboard-cyan" alt="REST API">
</p>

---

## What is SkillForge?

SkillForge is a **stateless AI skill runtime** that runs inside Docker. Start the container and instantly get access to **51+ production-ready skills** across 10 categories — no setup, no database, no boilerplate.

**The problem:** Every developer keeps re-writing the same utility code — CSV converters, regex builders, Dockerfile generators, API scaffolders, code analyzers. AI coding agents (Cursor, Cursor, Cursor) can help, but they lack standardized, reusable tools.

**The solution:** SkillForge packages common developer tasks as **stateless workers** with an identical contract: `input → output`. You don't write them; you *use* them — from the dashboard, REST API, CLI, or directly from your AI coding agent.

### Key Principles

| Principle | Detail |
|-----------|--------|
| **Docker-first** | `docker compose up` gives you the full runtime + web dashboard on port `9147` |
| **Standard contract** | Every skill returns `{success, data, error, metadata}` — alwa