Skills
Create and upload skills
Build custom skills in the editor, generate with AI, or upload a zip archive.
What is it?
Project skills are custom playbooks for one project. Create them in the Create Skill editor, generate a draft with Create with AI, or Upload skill as a zip file.
Project Owner or Admin can create, edit, and delete project skills.
Create Skill editor
- Open Skills in the project sidebar.
- Choose Create Skill.
- Fill in Name, Slug, and Description.
- Write instructions in
SKILL.md(required). - Add optional files or folders (for example
references/). - Save.
The slug must use lowercase letters, numbers, and single hyphens only (for example my-onboarding-skill).
Create with AI
- In the editor, open Create with AI.
- Describe what the skill should do (minimum 100 characters).
- Submit. Clankee generates a draft skill you can edit before saving.
AI skill generation uses team credits. If the team is out of credits, generation stops until you top up or upgrade. See Billing and credits.
Upload skill zip
- Open Skills.
- Choose Upload skill.
- Select a
.ziparchive. - Confirm the parsed Name, Description, and Slug.
- Upload.
Zip requirements
| Requirement | Detail |
|---|---|
SKILL.md | Must be present (at the archive root or in one top-level folder) |
| YAML frontmatter | name and description fields required |
| Slug | Lowercase letters, numbers, single hyphens |
| File types | Text and markdown files; no binary or unsafe HTML |
Common errors:
- The archive must include SKILL.md.
- SKILL.md must include YAML frontmatter.
- Use lowercase letters, numbers, and single hyphens only. (slug)
Edit or delete a project skill
- Open the skill from Available (Project filter) or Installed, then choose Edit.
- To delete permanently, use Delete on a project skill. This removes the skill and its files.
Permissions
Create, update, delete, and upload require project update permission (Owner/Admin). Members can view skills but cannot change them.