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

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.