From db92f3c33961caa02c99c6325ebf5aaf0f581925 Mon Sep 17 00:00:00 2001 From: Oz Sayag Date: Sun, 1 Feb 2026 09:44:01 +0200 Subject: [PATCH 1/2] refactor: improve skill descriptions using proven patterns Rewrote base44-cli and base44-sdk descriptions following patterns from top skills on skills.sh (vercel-react-best-practices, supabase-postgres). Changes: - Use "Use when" + verb-based triggers (initializing, configuring, deploying) - Use "Triggers on tasks involving" + concrete items - Add clear handoff between skills for configuration vs SDK usage - Remove aggressive language (AUTHORITATIVE, NEVER assume) - Simplify structure from numbered lists to flowing prose This addresses an issue where Claude didn't activate the CLI skill when implementing agent features, leading to incorrect guidance about dashboard configuration instead of CLI-based agent setup. Co-authored-by: Cursor --- skills/base44-cli/SKILL.md | 2 +- skills/base44-sdk/SKILL.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/skills/base44-cli/SKILL.md b/skills/base44-cli/SKILL.md index 1358947..c8432b3 100644 --- a/skills/base44-cli/SKILL.md +++ b/skills/base44-cli/SKILL.md @@ -1,6 +1,6 @@ --- name: base44-cli -description: "Use for Base44 CLI operations and project initialization. Triggers: user wants to create/initialize a new Base44 project; user mentions CLI commands (npx base44, yarn base44, create, login, logout, whoami, deploy, entities push, site deploy, functions deploy); directory is empty or missing base44/config.jsonc; user says 'create a Base44 app/project', 'setup Base44', 'deploy to Base44', 'push entities'. This skill is the PREREQUISITE for base44-sdk - always use this first for new projects before building features." +description: "Base44 CLI for project setup and resource configuration. Use when initializing projects, configuring entities/functions/agents, or deploying to Base44. Triggers on tasks involving 'npx base44' commands, pushing resources, or setting up a new Base44 app. This skill defines how resources are configured - consult before implementing features that need configuration." --- # Base44 CLI diff --git a/skills/base44-sdk/SKILL.md b/skills/base44-sdk/SKILL.md index 3a40834..75de510 100644 --- a/skills/base44-sdk/SKILL.md +++ b/skills/base44-sdk/SKILL.md @@ -1,6 +1,6 @@ --- name: base44-sdk -description: "**ALWAYS ACTIVATE** if ANY of these conditions are true: (1) User's prompt contains the word 'base44' or 'Base44' in ANY context; (2) Current directory contains a 'base44/' subfolder; (3) Code contains imports from '@base44/sdk'; (4) User mentions Base44 SDK modules: entities, auth, agents, functions, integrations, analytics. **ACTIVATION IS MANDATORY** - do not hesitate, do not search the web, do not read documentation files first. ACTIVATE IMMEDIATELY and let the skill instructions handle the context. This skill handles: application development, SDK usage, feature implementation, and writing code with Base44 APIs. The skill itself will determine the appropriate action based on whether this is a new project or existing project scenario." +description: "Base44 SDK for building features in existing projects. Use when writing code with Base44 modules (entities, auth, agents, functions, integrations). Triggers on tasks involving @base44/sdk imports, CRUD operations, or implementing features in a base44/ project. For resource configuration (creating entities/agents), see base44-cli skill first." --- # Base44 Coder From 60cc548567a0a160e8353ae279e297a507415067 Mon Sep 17 00:00:00 2001 From: Oz Sayag Date: Sun, 1 Feb 2026 10:03:30 +0200 Subject: [PATCH 2/2] fix: add MANDATORY instruction to prevent pattern inference Claude was seeing the skill trigger but choosing not to activate because it assumed it could infer Base44 config formats from other files. This adds explicit "MANDATORY: Do not infer" language to both skills. Blends top-skill patterns (Use when, Triggers on) with strong mandatory language to address overconfidence in pattern-matching. Co-authored-by: Cursor --- skills/base44-cli/SKILL.md | 2 +- skills/base44-sdk/SKILL.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/skills/base44-cli/SKILL.md b/skills/base44-cli/SKILL.md index c8432b3..c264283 100644 --- a/skills/base44-cli/SKILL.md +++ b/skills/base44-cli/SKILL.md @@ -1,6 +1,6 @@ --- name: base44-cli -description: "Base44 CLI for project setup and resource configuration. Use when initializing projects, configuring entities/functions/agents, or deploying to Base44. Triggers on tasks involving 'npx base44' commands, pushing resources, or setting up a new Base44 app. This skill defines how resources are configured - consult before implementing features that need configuration." +description: "Base44 CLI for project setup and resource configuration. Use when initializing projects, configuring entities/functions/agents, or deploying to Base44. Triggers on tasks involving 'npx base44' commands, pushing resources, or setting up a new Base44 app. MANDATORY: Do not infer Base44 configuration formats from patterns or other files - activate this skill to get the exact schemas required." --- # Base44 CLI diff --git a/skills/base44-sdk/SKILL.md b/skills/base44-sdk/SKILL.md index 75de510..e6dc41e 100644 --- a/skills/base44-sdk/SKILL.md +++ b/skills/base44-sdk/SKILL.md @@ -1,6 +1,6 @@ --- name: base44-sdk -description: "Base44 SDK for building features in existing projects. Use when writing code with Base44 modules (entities, auth, agents, functions, integrations). Triggers on tasks involving @base44/sdk imports, CRUD operations, or implementing features in a base44/ project. For resource configuration (creating entities/agents), see base44-cli skill first." +description: "Base44 SDK for building features in existing projects. Use when writing code with Base44 modules (entities, auth, agents, functions, integrations). Triggers on tasks involving @base44/sdk imports, CRUD operations, or implementing features in a base44/ project. MANDATORY: For resource configuration (entities/functions/agents), activate base44-cli first - do not infer config formats from patterns." --- # Base44 Coder