From b3aad5214c05a96cf0ecfafc00557f6242b8f37b Mon Sep 17 00:00:00 2001 From: Pavel Tarnopolsky Date: Thu, 26 Mar 2026 12:07:05 +0200 Subject: [PATCH 1/3] feat: add sourcePackage frontmatter support to sync-cli-skill Update the sync-cli-skill to write a sourcePackage field (name + version) into skills/base44-cli/SKILL.md frontmatter during sync. This lets the Base44 CLI detect when installed skills are out of date. Also adds .superset/ to .gitignore. Co-Authored-By: Mastra Code (anthropic/claude-opus-4-6) --- .claude/skills/sync-cli-skill/SKILL.md | 7 +++++-- .gitignore | 3 +++ 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/.claude/skills/sync-cli-skill/SKILL.md b/.claude/skills/sync-cli-skill/SKILL.md index 4cef952..ec64060 100644 --- a/.claude/skills/sync-cli-skill/SKILL.md +++ b/.claude/skills/sync-cli-skill/SKILL.md @@ -314,7 +314,7 @@ After processing all changed commands, update the SKILL.md of each affected skil - Keep the existing structure and formatting of each skill - Do NOT change the frontmatter description unless explicitly asked -### Step 7: Update CLI_VERSION +### Step 7: Update CLI_VERSION and Skill Frontmatter After successfully updating all changed commands: @@ -324,7 +324,9 @@ After successfully updating all changed commands: git describe --tags --always ``` -2. Update `CLI_VERSION` in the skills repository root with the new version +2. Update `CLI_VERSION` in the skills repository root with the new version (e.g., `v0.0.47`) + +3. Update the `sourcePackage.version` field in `skills/base44-cli/SKILL.md` frontmatter to match (without the `v` prefix, e.g., `0.0.47`). This allows the Base44 CLI to detect when installed skills are out of date. ### Step 8: Present Summary @@ -351,6 +353,7 @@ After all updates, present a summary to the user: - references/entities-push.md (updated description) - SKILL.md (updated command table, added timeout note) - CLI_VERSION (v0.0.17 → v0.0.20) +- skills/base44-cli/SKILL.md frontmatter sourcePackage.version (0.0.17 → 0.0.20) ### Breaking Changes (highlight prominently) - `create`: `-n, --name` option converted to positional argument diff --git a/.gitignore b/.gitignore index 79fc4b7..a8a6ed0 100644 --- a/.gitignore +++ b/.gitignore @@ -20,5 +20,8 @@ Thumbs.db *.swp *.swo +# Superset +.superset/ + # Node (if applicable) node_modules/ From 7676a49b16109e2a5d411e37ffc58da20aa33b37 Mon Sep 17 00:00:00 2001 From: Pavel Tarnopolsky Date: Thu, 26 Mar 2026 15:30:34 +0200 Subject: [PATCH 2/3] fix: specify sourcePackage.name as base44 in sync-cli-skill instructions Co-Authored-By: Mastra Code (anthropic/claude-opus-4-6) --- .claude/skills/sync-cli-skill/SKILL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.claude/skills/sync-cli-skill/SKILL.md b/.claude/skills/sync-cli-skill/SKILL.md index ec64060..5e522ca 100644 --- a/.claude/skills/sync-cli-skill/SKILL.md +++ b/.claude/skills/sync-cli-skill/SKILL.md @@ -326,7 +326,7 @@ After successfully updating all changed commands: 2. Update `CLI_VERSION` in the skills repository root with the new version (e.g., `v0.0.47`) -3. Update the `sourcePackage.version` field in `skills/base44-cli/SKILL.md` frontmatter to match (without the `v` prefix, e.g., `0.0.47`). This allows the Base44 CLI to detect when installed skills are out of date. +3. Update the `sourcePackage` field in `skills/base44-cli/SKILL.md` frontmatter. Set `name` to `base44` (the npm package being synced) and `version` to the new version without the `v` prefix (e.g., `0.0.47`). This allows the Base44 CLI to detect when installed skills are out of date. ### Step 8: Present Summary From 9b034efd215e8d2ba4b4c852b07d038c4acd813b Mon Sep 17 00:00:00 2001 From: Pavel Tarnopolsky Date: Sun, 29 Mar 2026 11:34:00 +0300 Subject: [PATCH 3/3] fix: nest sourcePackage under metadata per agent skills spec The agentskills.io spec reserves top-level frontmatter for standard fields. Custom fields like sourcePackage belong under the metadata key-value map. Co-Authored-By: Mastra Code (anthropic/claude-opus-4-6) --- .claude/skills/sync-cli-skill/SKILL.md | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/.claude/skills/sync-cli-skill/SKILL.md b/.claude/skills/sync-cli-skill/SKILL.md index 5e522ca..b91a602 100644 --- a/.claude/skills/sync-cli-skill/SKILL.md +++ b/.claude/skills/sync-cli-skill/SKILL.md @@ -326,7 +326,14 @@ After successfully updating all changed commands: 2. Update `CLI_VERSION` in the skills repository root with the new version (e.g., `v0.0.47`) -3. Update the `sourcePackage` field in `skills/base44-cli/SKILL.md` frontmatter. Set `name` to `base44` (the npm package being synced) and `version` to the new version without the `v` prefix (e.g., `0.0.47`). This allows the Base44 CLI to detect when installed skills are out of date. +3. Update `metadata.sourcePackage` in `skills/base44-cli/SKILL.md` frontmatter. Set `name` to `base44` (the npm package being synced) and `version` to the new version without the `v` prefix (e.g., `0.0.47`). Example: + ```yaml + metadata: + sourcePackage: + name: base44 + version: 0.0.47 + ``` + This allows the Base44 CLI to detect when installed skills are out of date. ### Step 8: Present Summary @@ -353,7 +360,7 @@ After all updates, present a summary to the user: - references/entities-push.md (updated description) - SKILL.md (updated command table, added timeout note) - CLI_VERSION (v0.0.17 → v0.0.20) -- skills/base44-cli/SKILL.md frontmatter sourcePackage.version (0.0.17 → 0.0.20) +- skills/base44-cli/SKILL.md frontmatter metadata.sourcePackage.version (0.0.17 → 0.0.20) ### Breaking Changes (highlight prominently) - `create`: `-n, --name` option converted to positional argument