UNIVERSAL_BLUEPRINT.md

# Luuna Skill Forge — Universal Blueprint

## Goal
Luuna Skill Forge must be usable across many model providers and local/cloud runtimes. It should create reusable skills, not one-time answers.

## Core idea
A Luuna skill has one neutral definition and many adapters.

Neutral skill definition:
- name
- purpose
- triggers
- inputs
- outputs
- context needed
- steps
- validation
- install notes

## Ten steps ahead

### 1. Neutral core
Design every skill first in a vendor-neutral format.

### 2. Provider adapters
Map the same skill to OpenAI, Claude, Gemini, LM Studio, Ollama, OpenRouter, Hugging Face and future providers.

### 3. Runtime adapters
Map the same skill to Python, Node.js, FastAPI, Tauri, React, PowerShell, Bash, Docker, n8n, CrewAI, LangGraph and MCP.

### 4. Skill registry
Keep all skills in one index with id, version, category, supported providers and supported runtimes.

### 5. Lifecycle
Use states: draft, validated, installed, active, deprecated, replaced.

### 6. Context contract
Every skill declares what information it needs before execution.

### 7. Adapter output
Every adapter outputs installable instructions for its target system.

### 8. Tests
Every skill includes dry-run tests, schema tests and one real usage example.

### 9. Improvement loop
When a task fails repeatedly, Skill Forge proposes a new missing skill or improves an old one.

### 10. Export formats
Every skill can export as Markdown, JSON, YAML, OpenAI tool schema, Claude instruction, Gemini instruction, LM Studio prompt, Ollama Modelfile, MCP tool note, n8n note, CrewAI task or LangGraph node.

## Package structure

```txt
luuna-provider-skill-kit/
├─ README.md
├─ UNIVERSAL_BLUEPRINT.md
├─ registry/skills.index.json
├─ agents/luuna-skill-forge.md
├─ prompts/universal-system-prompt.md
├─ schemas/universal-skill.schema.json
├─ adapters/provider-adapter-map.md
├─ adapters/runtime-adapter-map.md
├─ skills/create-skill.md
├─ tests/universal-test-harness.md
└─ examples/
```

## Decision
Use full skill-kit architecture as the main path. A single prompt is only a fallback.