Skip to content

Bundled Skill Quality: gh-issues invalid frontmatter + excessive size (33.8KB) #2

@potterdigital

Description

@potterdigital

Bundled Skill Quality Issue: gh-issues

Skill Location: /skills/gh-issues/SKILL.md

Issues Found

  1. Invalid Frontmatter Field - Contains user-invocable: true which is not a standard OpenClaw frontmatter field
  2. Excessive Size - 33.8KB (target <5KB for progressive disclosure)
  3. Progressive Disclosure Violation - Entire workflow in SKILL.md instead of references/

Required Fixes

1. Remove Invalid Field

Remove user-invocable: true from frontmatter. Valid fields are:

  • name
  • description
  • license
  • compatibility
  • metadata

2. Apply Progressive Disclosure

Move detailed content to references/:

  • references/workflow-phases.md - 6-phase workflow details
  • references/api-examples.md - GitHub API curl examples
  • references/troubleshooting.md - Error handling

Keep SKILL.md to:

  • Quick overview
  • Usage triggers
  • High-level workflow steps
  • References to detailed docs

Target: Reduce SKILL.md to <5KB

Standards Reference

  • OpenClaw conventions: frontmatter fields are strictly defined
  • Progressive disclosure: metadata (~100 words) always loaded, SKILL.md (<5KB) loaded on trigger, references loaded as needed
  • Anthropic patterns: lean primary document, details in references

Priority

Medium-High - Invalid frontmatter may cause parsing issues; excessive size impacts context window efficiency.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions