> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fliiq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Promoting Skills

> Move local skills to core

Skills start as local (`.fliiq/skills/`) and can be promoted to core (`skills/core/`) so they ship with your project for all users.

## Two Tiers

| Tier      | Location                | Scope                                   |
| --------- | ----------------------- | --------------------------------------- |
| **Local** | `.fliiq/skills/<name>/` | Per-user or per-project                 |
| **Core**  | `skills/core/<name>/`   | Ships with Fliiq, available to everyone |

## Promoting a Skill

```bash theme={null}
fliiq skill-promote <name>
```

This:

1. Validates the skill has all 3 required files (SKILL.md, fliiq.yaml, main.py)
2. Copies from `.fliiq/skills/<name>/` to `skills/core/<name>/`
3. Removes the local copy

If validation fails (missing files, invalid schema), the command exits with an explicit error.

## Checking Skill Sources

```bash theme={null}
fliiq skill-list
```

Each skill shows its source:

```
read_file       (core)   Read the contents of a file
web_search      (core)   Search the web using Brave Search API
spotify         (local)  Create and manage Spotify playlists
weather         (local)  Get current weather for a city
```

## When to Promote

Promote a skill when:

* You've tested it thoroughly and it works reliably
* Other users or projects would benefit from it
* You want it committed to your repository

Keep a skill local when:

* It's experimental or unfinished
* It's specific to one project
* You're still iterating on the API integration