- a name,
- a description that tells Lovable when to use it,
- and markdown instructions that Lovable follows when the skill applies.
/ command paired with your prompt, or let Lovable apply it automatically when the task matches.
Skills are portable markdown-based files, so you can inspect exactly what Lovable is being told, share them with teammates, import them from GitHub or ZIP, and improve them over time.
Skills vs. instructions
Skills and instructions complement each other.- Instructions are always included in context. Use them for rules and conventions that apply to everything Lovable does, such as coding standards, brand guidelines, or your project’s domain terminology.
- Skills are loaded on demand when the request matches. Use them for instructions that only matter for specific kinds of tasks, such as running a release checklist, drafting a customer reply, or producing a particular kind of content.
Types of skills
Skills come in three types. They differ in who manages them and who can use them./ in a project chat. Lovable can also apply one automatically when your request matches it.
What skills are for
Skills work best for repeatable, task-specific workflows. Use them when you want Lovable to handle the same kind of task the same way each time. Common examples include:- Launch checks: pre-ship checklists, release readiness reviews, and go/no-go reviews
- Recurring content: release notes, changelog entries, support replies, and marketing copy
- Review playbooks: landing-page reviews, copy reviews, accessibility passes, and search engine optimization reviews
- Internal processes: onboarding flow reviews, quality assurance passes, billing setup, and partner handoff steps
- Task-specific style guides: tone of voice, brand persona, or formatting rules for a particular kind of content
- Reusable team workflows: research routines, document templates, partner integrations, or other repeated team processes
Role-based access for skills
Access to the skills your workspace shares, both the ones your team adds and the ones built by Lovable, follows your workspace role. Personal skills are the exception: you add your own, with no admin involved.Add a custom workspace skill
Workspace owners and admins can add custom workspace skills in five ways. Four options are available from Workspace settings → Skills → Add, and one starts from a project chat after Lovable does something you want to reuse.Build with Lovable
Choose Add → Build with Lovable to start a guided skill-building conversation. Lovable opens the dashboard with a starter prompt:Write manually
Choose Add → Write manually to write a skill from scratch. The form has three fields:- Name: a short, permanent ID like
launch-checklistorsupport-reply. Use lowercase letters, numbers, and hyphens only. - Description: the trigger Lovable uses to decide when to load the skill. Start with “Use when…” and describe the skill’s scope and boundaries.
- Content: the instructions Lovable follows once the skill is loaded, such as steps, constraints, examples, and the expected output.
Import from GitHub
Choose Add → Import from GitHub and paste a public GitHub repository URL. A skill is a directory containing aSKILL.md file, and the URL tells Lovable which directory to take. Two forms work:
- Whole repository,
https://github.com/owner/repo. Use this when the repository has one skill, withSKILL.mdat the root. - Subdirectory,
https://github.com/owner/repo/tree/main/launch-checklist. Use this when one repository has several skills. The directory must containSKILL.mddirectly, and any branch works in place ofmain. A direct file URL also works, such ashttps://github.com/owner/repo/blob/main/launch-checklist/SKILL.md, and Lovable imports the parent directory that containsSKILL.md.
Upload a ZIP
Choose Add → Upload ZIP, and drag in or browse for a.zip or .skill file. The archive must contain a SKILL.md file either at the root or inside one wrapping folder. Any bundled files referenced by the skill should sit alongside SKILL.md in the same directory.
The file you upload can be up to 50 MB, compressed. After Lovable unpacks it, the skill itself can include up to 200 files and 10 MB, with each file up to 1 MB. macOS metadata files, such as __MACOSX/ and .DS_Store, are ignored at the root.
Example: importing a skill from Claude
Skills in Lovable use the same SKILL.md shape as Anthropic’s Claude and any other tool that follows the Agent Skills convention. If you already built a skill in Claude, export it as a .skill or .zip file, then upload it in Lovable from Workspace settings → Skills → Add → Upload ZIP.
Lovable validates the archive and publishes the skill to your workspace with its name, description, instructions, and bundled files intact. From there, it behaves like any other custom workspace skill.
This works in the other direction too: download any custom workspace skill from Lovable as a .zip, then upload it into another tool that supports the same SKILL.md shape.
Save from a project chat
You can turn a successful project chat interaction into a reusable skill without leaving the project. After Lovable completes a task the way you want, say “save that as a skill” and describe when the skill should apply. Lovable drafts the skill, including a name, description, and instructions, then shows it in the project chat for you to review. When you approve the draft, the skill is published to your workspace.Use a skill
Lovable can use skills in two ways: automatically, or when you invoke one directly.Let Lovable choose automatically
When your request matches a skill’s description, Lovable can apply that skill automatically. You do not need to do anything special. Just describe what you want. You can keep many skills in the same workspace. Lovable only loads the skills that seem relevant to the current request. Alaunch-checklist skill, for example, only applies when someone tells Lovable they are about to ship. It does not affect unrelated work.
/skill-name). See Enable or disable automatic use for details.Invoke a skill directly
Type/ in the chat input to open the Skills list, choose a skill, and then continue typing your request. You can also open the same list from the + button next to the chat input, under Add context → Skills. The skill appears as a tag in your message, telling Lovable which instructions to apply.
Think of the skill as the how and your prompt as the what.
For example, with a launch-checklist skill in your workspace, you could send:
/skill-name. When automatic use is disabled, Lovable stops applying the skill on its own. The skill stays visible, and you can still invoke it yourself.Manage custom workspace skills
Use Workspace settings → Skills to manage custom workspace skills. Project settings → Skills shows the same list while you work in a project, because a workspace has one set of skills that every project in it uses. The available actions depend on your role. See Role-based access for skills.Edit or delete a custom workspace skill
Go to Workspace settings → Skills to see every skill in your workspace. Open a custom workspace skill to edit its description or instructions, or delete it if you no longer need it. Deleting a skill removes it from the workspace, so no project in that workspace can use it again.Download a custom workspace skill
Open any custom workspace skill in Workspace settings → Skills and click Download to export the full skill package as a.zip.
Use downloads to back up a skill, move it to another workspace, share it with a teammate to edit offline, or upload it into another tool that supports the same SKILL.md shape, such as Claude.
Personal skills cannot be downloaded.
Enable or disable automatic use
Every custom workspace skill has Use automatically enabled by default. When automatic use is enabled, Lovable can apply the skill automatically whenever the task matches, and you can also invoke it yourself with a slash command (/skill-name).
When automatic use is disabled, Lovable does not apply the skill on its own in any project, even when the task matches. The skill stays available to the workspace. It still appears in the Skills list when you type /, and you can invoke it yourself with a slash command.
Workspace owners and admins can enable or disable automatic use for a skill from Workspace settings → Skills, or from Project settings → Skills while working in a project. The setting applies across the entire workspace.
Personal skills have no such setting, and no one else can disable one.
Personal skills
Personal skills are your own, and each workspace you belong to has a separate set. Lovable applies them in every project you open in that workspace. Your teammates never see them, you do not need to be an admin, and they are available on all plans. You find them in Account settings → Personal skills. Choose the workspace at the top of the page before you add anything. A skill you add in one workspace does not appear in your other workspaces, and a workspace you join starts with none.Add a personal skill
Select Add skill and fill in the same three fields as a custom workspace skill: a name, a description, and the instructions. To bring in a skill someone else wrote, open the menu beside Add skill and choose Import skills. You can import from a public GitHub repository, or from a.zip or .skill file.
To change or delete a skill, select it in the list.
A personal skill has the same parts, naming rules, and limits as a custom workspace skill. An imported one keeps its bundled files. See Anatomy of a skill.
Ask Lovable to write a personal skill
Ask Lovable in a project chat to create, change, or delete a personal skill, and Lovable edits your set for you. This works in Build mode. In Chat mode and Plan mode Lovable reads your personal skills but does not change them.How personal skills differ
Personal skills work like custom workspace skills, with these differences.- Lovable applies a personal skill whenever a task matches it, and you can invoke one by typing
/and its name. Personal skills have no setting for automatic use, so workspace admins and owners cannot switch one off. - When skill names conflict, Lovable prioritizes personal skills over workspace skills.
- You cannot download a personal skill. Custom workspace skills offer Download and personal skills do not, so moving one to another workspace means copying its text across yourself.
Anatomy of a skill
Each skill has three required parts.- Name: a short, permanent identifier for the skill, between 1 and 64 characters. Use lowercase letters, numbers, and hyphens only, for example,
launch-checklist,release-notes, orsupport-reply. Names cannot start or end with a hyphen, and cannot contain consecutive hyphens. The namegoalis reserved for the built-in Goal command. The name cannot be changed after creation. To rename a skill, delete it and create a new one. - Description: a short sentence that tells Lovable when to use the skill. Start with “Use when…” and describe the trigger as concretely as possible. The description is the main signal Lovable uses to decide whether to load the skill for a message.
- Instructions: the markdown body Lovable follows once the skill is loaded. Include the steps, constraints, examples, edge cases, and output format Lovable should follow.
SKILL.md file can be up to 100,000 characters.
Bundled files
A skill can also include bundled files. These are optional extra files that travel with the skill. Use bundled files for longer references, templates, or small scripts that the instructions point to, such asreference.md.
Bundled files appear in the Bundled files list when you expand the skill, and they are included when you download or import the skill. Skills authored in the project chat usually do not need bundled files. They are most common for skills imported from GitHub or a ZIP.
Each bundled file can be up to 1 MB. A skill can include up to 200 files and up to 10 MB total across all files.
Write clear skill descriptions
A well-written description is the most important part of a skill. The description tells Lovable when to load the skill. If the description is vague, Lovable may not load the skill when you expect it to, or may load it for unrelated tasks. Good descriptions define both when the skill should apply and when it should not. Clear boundaries help Lovable load the right skill consistently without pulling it into unrelated tasks. Too vague- the trigger (auditing an existing page),
- the scope (checking metadata, headings, internal links),
- and the boundary (not for writing new copy).
Example skill
Here is a complete example of a pre-launch checklist skill that runs whenever you tell Lovable you are about to ship: NameSKILL.md.
For example, the launch checklist could keep deeper search engine optimization and accessibility verification steps in separate bundled files instead of putting everything directly into SKILL.md.
Best practices
- Lead with the trigger. Start the description with “Use when…” and describe the request as concretely as you can. The description is how Lovable decides whether to load the skill.
- Give each skill one job. A skill that tries to cover too much may load in the wrong situations or fail to give Lovable clear guidance. Split broad guidance into focused skills, and let each one own a specific task.
- Include boundaries and “avoid” sections. Telling Lovable what not to do is often as important as telling it what to do. Strong skills define both the intended behavior and the behaviors to avoid.
- Put always-on rules in instructions instead. If a rule should apply to every message, it belongs in workspace instructions. Skills are for behavior that only matters in specific situations.
- Write the instructions like a short playbook. Use short sections, bullet points, and direct instructions. Skills become part of the context Lovable reads, so shorter, focused instructions are easier to follow.
- Show, do not just tell. Where helpful, include concrete values, example copy, or example outputs. Lovable follows specific instructions more reliably than abstract ones.
- Review and prune. As your workspace grows, retire skills that are no longer needed. A skill with stale or incorrect instructions is worse than no skill at all.
FAQ
What is the character limit for a skill?
What is the character limit for a skill?
SKILL.md, including the description and instructions, can be up to 100,000 characters. Names are limited to 64 characters. A skill can also include bundled files alongside SKILL.md: each file can be up to 1 MB, and a skill can contain up to 200 files totaling 10 MB. Custom workspace skills and personal skills have the same limits.Can I rename a skill?
Can I rename a skill?
Can I disable automatic use for a skill?
Can I disable automatic use for a skill?
/skill-name). Re-enable automatic use at any time from the same place. Personal skills have no such setting.How does Lovable decide when to use a skill?
How does Lovable decide when to use a skill?
What is the difference between a skill and instructions?
What is the difference between a skill and instructions?
Can more than one skill apply to the same request?
Can more than one skill apply to the same request?
Do skills cost credits?
Do skills cost credits?
- Creating a skill from the project chat (Build with Lovable or “save that as a skill”): is priced like any other message in the project chat.
- Adding a skill from Workspace settings (Write manually, Import from GitHub, or Upload ZIP): free. Settings actions do not consume credits.
- Using a skill: no extra cost on top of the message. The message is priced as build usage, based on its complexity. A skill may indirectly affect cost if the instructions it loads lead Lovable to do more work.
Why don't I see my personal skill in a project?
Why don't I see my personal skill in a project?
Can my teammates see my personal skills?
Can my teammates see my personal skills?
Can I get a deleted personal skill back?
Can I get a deleted personal skill back?
Where are skills stored?
Where are skills stored?
Can I move a skill between workspaces?
Can I move a skill between workspaces?
.zip from one workspace, then import the ZIP into another. The imported skill arrives with the same name, description, and contents. Personal skills cannot be downloaded, and each set stays in the workspace you created it in.Can I download Lovable's built-in skills?
Can I download Lovable's built-in skills?