Skip to content

fix(skill): align generation template with skill-creator best practices#1434

Open
kagura-agent wants to merge 1 commit intoMemTensor:mainfrom
kagura-agent:fix/1423-skill-generation-template
Open

fix(skill): align generation template with skill-creator best practices#1434
kagura-agent wants to merge 1 commit intoMemTensor:mainfrom
kagura-agent:fix/1423-skill-generation-template

Conversation

@kagura-agent
Copy link
Copy Markdown

What

Aligns the skill generation prompt template (STEP1_SKILL_MD_PROMPT) with skill-creator best practices, addressing all 6 issues raised in #1423.

Changes

  1. Name constraint: 2-4 word kebab-case (was unconstrained)
  2. Frontmatter: Limited to name + description only
  3. No extra files: Explicitly prohibits README/CHANGELOG/etc generation
  4. Assume smart agent: Only include info the agent doesn't already know
  5. Stronger trigger rules: Description must include trigger scenarios + keywords
  6. Progressive disclosure: Multi-variant skills should use references/ subdirectory

Question for maintainers

The current template includes metadata: { openclaw: { emoji } } in frontmatter. Per best practices, frontmatter should only have name and description. I've moved the metadata guidance to an HTML comment at the end of the file body, noting it as an optional OpenClaw extension. Please let me know if you'd prefer a different approach.

Testing

  • Manual review of prompt template alignment with spec
  • Only string literal changes, no logic affected

Fixes #1423

- Constrain skill name to 2-4 word kebab-case
- Limit frontmatter to name + description only
- Add rule against creating extra documentation files
- Add 'assume agent is smart' principle
- Strengthen trigger condition requirements in description
- Clarify metadata as optional OpenClaw extension

Fixes MemTensor#1423
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.

[Enhancement] Skill generation template does not follow skill-creator best practices

1 participant