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

Promoting a Skill

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

Each skill shows its source:

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