Skip to content

Enrich SKILL.md frontmatter with OpenClaw schema fields#116

Merged
TechNickAI merged 2 commits into
mainfrom
feat/skill-frontmatter-enrichment
Apr 29, 2026
Merged

Enrich SKILL.md frontmatter with OpenClaw schema fields#116
TechNickAI merged 2 commits into
mainfrom
feat/skill-frontmatter-enrichment

Conversation

@TechNickAI
Copy link
Copy Markdown
Owner

Summary

  • Adds typed metadata.openclaw fields across all 24 skills: homepage, category, and (where applicable) requires.bins, os, install specs
  • Pure additive change — zero existing fields removed; each skill's version bumped, root VERSION 0.28.0 → 0.29.0
  • Fills in missing required fields on three skills: tgcli-topics (version + triggers + metadata), vapi-calls (triggers + metadata + apiKey), workflow-builder (triggers)

What changed

Per-skill additions:

  • homepage: https://github.com/TechNickAI/openclaw-config/tree/main/skills/<skill> on every skill
  • category: integrations / productivity / development / knowledge / meta / operations
  • requires.bins: declared on apple-photos (osxphotos), claude-code (claude), gateway-restart & openclaw (openclaw), tgcli-topics (tgcli, python3), todoist (td)
  • os: [darwin]: alongside existing platform: macos on apple-photos
  • install spec: added for todoist (npm @doist/todoist-cli); preserved tgcli's existing go install spec

Schema source

Pulled the typed schema from the installed plugin SDK at ~/.nvm/.../openclaw/dist/plugin-sdk/src/agents/skills/types.d.ts:

```typescript
type OpenClawSkillMetadata = {
always?: boolean; skillKey?: string; primaryEnv?: string;
emoji?: string; homepage?: string; os?: string[];
requires?: { bins?: string[]; anyBins?: string[]; env?: string[]; config?: string[] };
install?: SkillInstallSpec[];
};
```

Skipped primaryEnv (project `skills/CLAUDE.md` forbids in favor of `apiKey.env`) and requires.env (avoids ambiguity about whether it gates eligibility — apiKey.env already documents env requirements).

Test plan

  • All 24 SKILL.md files parse as valid YAML
  • `uv run --with pytest --with pyyaml --with httpx pytest tests/ -v` → 184 passed, 50 skipped (API keys unavailable, expected)
  • `git diff` confirms no field deletions (only version-string removals from version bumps)
  • Roll out to fleet starting with Cora; verify all skills load
  • Verify Julianna/Ace deployment

🤖 Generated with Claude Code

Add typed metadata.openclaw fields across all 24 skills:
- homepage pointing to each skill's source on GitHub
- category for organizational grouping
- requires.bins where the skill genuinely needs a CLI (apple-photos,
  claude-code, gateway-restart, openclaw, tgcli-topics, todoist)
- os: [darwin] alongside existing platform: macos on apple-photos
- install spec for todoist (npm @doist/todoist-cli)

Filled in missing required fields:
- tgcli-topics: added version, triggers, metadata block
- vapi-calls: added triggers and metadata.openclaw with apiKey
- workflow-builder: added triggers block

Pure additions — zero existing fields removed. Bumped each touched
skill's version and root VERSION 0.28.0 → 0.29.0.

Skipped primaryEnv (project CLAUDE.md forbids in favor of apiKey.env)
and requires.env (avoids ambiguity around whether it gates eligibility;
apiKey.env already documents env requirements informally).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 2 potential issues.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 841f22c. Configure here.

Comment thread skills/librarian/SKILL.md Outdated
Comment thread skills/vapi-calls/SKILL.md Outdated
- librarian homepage: point to its own skill dir (was incorrectly
  pointing at cortex; replacement: cortex already declares the
  successor)
- vapi-calls emoji: ☎️ instead of 📞 (deconflicts from quo)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@TechNickAI TechNickAI merged commit 5f34fd7 into main Apr 29, 2026
6 checks passed
@TechNickAI TechNickAI deleted the feat/skill-frontmatter-enrichment branch April 29, 2026 01:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant