agentleFS
charanjit-singhcharanjit-singh/lovable-skills/skills/lovable-prompting-playbook/SKILL.md

lovable-prompting-playbook

Skill10 starsChanged 6 months agoMITView on GitHub

Use when planning a session in Lovable, breaking a feature into prompts, asking Lovable to refactor or debug, or writing a backlog of Lovable prompts. Not when actually executing inside Lovable — this guides how to phrase work, not the work itself.

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 2 are distinctive, and 3 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    After each prompt, review the chat diff before moving on.

    line 39
  2. Very specific:

    Use a skill invocation (/refactor-safe-diff) to constrain scope.

    line 46
  3. Very specific:

    Add knowledge entries for: stack, brand, banned patterns (any, inline Supabase in components).

    line 73
  4. Distinctive:

    Add this repo's skills to your workspace and let descriptions trigger them automatically.

    line 74
  5. Very specific:

    Keep prompts in a note (Linear, Notion, or prompts.md) so they can be re-run on a new branch.

    line 75

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Lovable prompting playbook

Lovable does best with small, specific, verifiable prompts. This skill helps you (or another agent) write prompts that ship.

Anatomy of a good Lovable prompt

[Context]   What part of the app, which files or routes.
[Goal]      What "done" looks like in user-visible terms.
[Approach]  Optional. Pick stack / pattern if it matters.
[Limits]    What NOT to change.
[Verify]    How you'll check it works.

Example:

On the /dashboard route, add a "Revenue (30d)" KPI card to the top row, using useRevenue30d (already exists). Show value, % delta, and a sparkline. Do not touch the other cards. I'll verify by loading the dashboard and comparing the number to Stripe.

Sequence work into prompts

Break a feature into 3–7 prompts, each shippable on its own:

  1. Schema — tables, RLS, types (migration-playbook).
  2. API — fetchers + hooks (typed-api-hooks-forms).
  3. UI shell — empty/loading/error layout (error-states-and-empty-ui).
  4. Wiring — connect UI to hooks.
  5. Edge cases — auth, permissions, validation.
  6. Polish — copy, a11y, mobile.

After each prompt, review the chat diff before moving on.

When Lovable goes off course

  • "Revert to the previous version and try again, keeping X unchanged."
  • "Show me only the diff for path/to/file.tsx."
  • "Stop. Summarize what you changed in the last 3 messages before continuing."
  • Use a skill invocation (/refactor-safe-diff) to constrain scope.

Pair prompts with skills

TaskSkills to invoke
New feature with Supabase/supabase-database-design then /typed-api-hooks-forms
New form/typed-api-hooks-forms (covers Zod + RHF)
Stripe webhook/stripe-payment-webhooks + /payment-webhook-idempotency
Before launch/lovable-ship-checklist
Slow page/performance-budget

Phrases that work well

  • "Implement X. Do not change Y."
  • "Add a checklist comment in the PR description listing every file you touched."
  • "If you are unsure between two approaches, ask me before writing code."
  • "Reuse the existing useFoo hook; do not create a duplicate."

Phrases that cause trouble

  • "Improve the app." — undefined target.
  • "Refactor everything." — invites scope creep; use /refactor-safe-diff with explicit files.
  • "Add a few small fixes." — bundle multiple things; you'll lose track of regressions.

Workspace setup recommendations

  • Add knowledge entries for: stack, brand, banned patterns (any, inline Supabase in components).
  • Add this repo's skills to your workspace and let descriptions trigger them automatically.
  • Keep prompts in a note (Linear, Notion, or prompts.md) so they can be re-run on a new branch.

Avoid

  • Mega-prompts that mix schema, UI, billing, and copy.
  • Trusting Lovable to "remember" earlier sessions — assume zero memory across chats.
  • Letting failing diffs accumulate; revert early.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.