noopsec/architecture-template
1
0
Fork 0
Code Issues 3 Pull requests Projects Releases Packages Wiki Activity Actions

SKILL.md does not follow OpenClaw skill format #1

New issue
Open
opened 2026-03-01 10:43:23 +00:00 by Zeus · 0 comments
Zeus commented 2026-03-01 10:43:23 +00:00
Copy link

The current SKILL.md reads like a generic README rather than an OpenClaw skill definition.

Expected: OpenClaw skills need:

  • YAML frontmatter with name, description, and optional metadata
  • Description that matches <available_skills> format (triggers, when to use, when NOT to use)
  • Clear step-by-step instructions for the agent to follow
  • No installation instructions (that goes in README)

Example of proper format: See any stock OpenClaw skill like coding-agent or weather.

Current: Generic README-style content with installation instructions, Python import examples, and a file structure table — none of which help an agent understand when/how to use the skill.

Suggestion: Rewrite SKILL.md as agent-facing instructions: "When the user asks you to document architecture, do X, Y, Z." Move everything else to README.md.

The current SKILL.md reads like a generic README rather than an OpenClaw skill definition. **Expected:** OpenClaw skills need: - YAML frontmatter with `name`, `description`, and optional `metadata` - Description that matches `<available_skills>` format (triggers, when to use, when NOT to use) - Clear step-by-step instructions for the agent to follow - No installation instructions (that goes in README) **Example of proper format:** See any stock OpenClaw skill like `coding-agent` or `weather`. **Current:** Generic README-style content with installation instructions, Python import examples, and a file structure table — none of which help an agent understand when/how to use the skill. **Suggestion:** Rewrite SKILL.md as agent-facing instructions: "When the user asks you to document architecture, do X, Y, Z." Move everything else to README.md.
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
master
No results found.
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
noopsec/architecture-template#1
No description provided.