Skip to main content
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

TierLocationScope
Local.fliiq/skills/<name>/Per-user or per-project
Coreskills/core/<name>/Ships with Fliiq, available to everyone

​
Promoting a Skill

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

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