@sogni-ai/sogni-creative-agent-skill/skills/README.md

Sogni Creative Agent Skill: agent skill and CLI for Sogni AI image, video, and music generation.

# Sogni Skills (per-skill markdown index)

The legacy `SKILL.md` at the repo root is the public entry point ingested by skill-loading hosts (Claude Code, OpenClaw, Hermes Agent, Manus AI, etc.) that load a skill as one artifact. This `skills/` directory is the **per-skill** view used by hosts that want to load a focused subset of capability rather than the whole monolith.

Each file is the canonical SKILL.md for one skill, kept in sync with the matching manifest exported from [`@sogni/creative-agent`](../../sogni-creative-agent/src/public-skill-runtime/index.ts). Frontmatter declares `name`, `description`, `always_loaded`, and `tool_names`; the body documents the LLM-callable tools and any constraints the host should respect.

## Always-loaded skills

Loaded automatically by every Sogni-hosted runtime. Hosts that mirror this layout should load these first, before any user-facing capability.

| Skill | Tools |
|---|---|
| [`quality_audit`](./quality_audit.md) | _(none — preflight rule set)_ |
| [`session_control`](./session_control.md) | `ask_clarifying_question`, `finalize_response` |
| [`asset_reference_management`](./asset_reference_management.md) | `create_asset_manifest`, `inspect_asset`, `label_asset`, `map_assets_for_model`, `validate_asset_references` |

## Capability skills

Available to every per-skill consumer. Sogni-hosted chat loads all capabilities and lets Structured Contracts v1 (`ToolGatingPolicy` in `@sogni/creative-agent`) gate per-turn visibility — the host never asks the model to load or unload skills explicitly. External skill-loading hosts (Claude Code, OpenClaw, Hermes Agent, Manus AI) are free to load focused subsets based on session needs.

| Skill | Tools |
|---|---|
| [`image_generation`](./image_generation.md) | `generate_image` |
| [`image_editing`](./image_editing.md) | `edit_image`, `restore_photo`, `apply_style`, `change_angle`, `refine_result` |
| [`video_generation`](./video_generation.md) | `generate_video` |
| [`video_editing`](./video_editing.md) | `animate_photo`, `sound_to_video`, `video_to_video`, `stitch_video`, `orbit_video`, `dance_montage`, `extend_video`, `replace_video_segment`, `overlay_video`, `add_subtitles` |
| [`music_generation`](./music_generation.md) | `generate_music` |
| [`media_analysis`](./media_analysis.md) | `analyze_image`, `analyze_video`, `extract_metadata` |
| [`persona_management`](./persona_management.md) | `resolve_personas`, `manage_memory` |
| [`app_settings`](./app_settings.md) | `set_content_filter` |
| [`composition_planning`](./composition_planning.md) | `enhance_prompt`, `compose_lyrics`, `compose_instrumental`, `compose_script`, `compose_workflow`, `compose_workflow_template` |

## How to consume

- **Whole-skill hosts** (Claude Code, OpenClaw): load the top-level [`SKILL.md`](../SKILL.md) as today.
- **Per-skill hosts** (future Sogni-hosted chat consumers, agents that want minimal token footprint): load [`skills/README.md`](./README.md) for the menu, then individual `skills/<id>.md` files for the capabilities the session needs.

## Sync source

These files are mirrored from `@sogni/creative-agent/src/public-skill-runtime/index.ts` (the `*_SKILL` constants in `ALL_BUILT_IN_SKILLS`). When the upstream manifest or constraints change, regenerate the matching file here. The runtime mjs itself is regenerated via `npm run sync:creative-agent-runtime`.

> **Note (2026-05-10 skill-loader retirement):** The chat-side `SkillRegistry` and its three LLM-callable management tools (`load_skill` / `unload_skill` / `list_active_skills`) were retired. The public-skill-runtime in `@sogni/creative-agent` is a separate publishing channel and still exports `ALL_BUILT_IN_SKILLS` + the per-skill `*_SKILL` constants as the canonical manifest list for this artifact's CLI / agent consumers — `skill_management` is no longer part of that list. Per-turn tool-surface composition for Sogni-hosted chat is owned by Structured Contracts v1 (`ContractRegistry`, `classifyTurn`, `compileToolsForTurn`, `dispatchToolCall`), typed media turn intent (`CreativeTurnPlannerFields`, `classifyMediaTurnIntent()`), and the per-tool `getToolPermission` / `getToolCostMetadata` helpers.