skill-frontmatter-doctor

What This Skill Does

The Skill Frontmatter Doctor is a specialized AI agent tool designed for OpenClaw developers to maintain the integrity and compliance of their skill documentation and configuration files. It acts as an automated auditor that reviews, validates, and suggests fixes for frontmatter, metadata, dependency requirements, installation scripts, and overall repository directory structures. By adhering strictly to the internal OpenClaw spec.json and standard templates, this skill ensures that every skill package is deployment-ready and conforms to the community's structural requirements. It prevents common configuration errors that lead to failed installations or misidentified skill functionalities.

Installation

To integrate this utility into your development workflow, use the standard OpenClaw installation command: clawhub install openclaw/skills/skills/52yuanchangxing/skill-frontmatter-doctor

Ensure that you have write access to your local development environment if you intend to apply the suggested file patches directly. The skill is designed to operate seamlessly within the openclaw/skills repository context.

Use Cases

This skill is best utilized in the following scenarios:

• Pre-publication Audits: Before submitting a skill to the hub, run the doctor to verify that the metadata accurately reflects your skill's capabilities and dependencies.
• Refactoring & Migration: When updating your skill to a new OpenClaw version, use the doctor to identify deprecated fields or required structural changes.
• Dependency Debugging: Automatically detect missing or incorrectly formatted requires blocks that could hinder user installation.
• Standardization: Ensure your directory tree, including resources and tests folders, follows the official OpenClaw hierarchy.

Example Prompts

1. "Check the current directory's frontmatter and metadata for compliance with the latest spec.json. Let me know if anything is missing."
2. "Review my skill's requires and install configuration to ensure they match the standardized format for OpenClaw skills."
3. "Here is my skill.yaml and directory list. Please provide a repair plan for the structural issues identified and a step-by-step checklist for remediation."

Tips & Limitations

• Safety First: The doctor is primarily a read-only advisor. While it can suggest code, it will never execute high-risk commands (like mass deletions) without explicit user confirmation.
• Dry-Run Preferred: Always interpret the doctor’s output as a proposal. Use the suggested 'dry-run' approach before applying changes to live configuration files.
• Constraint Adherence: The skill is strictly governed by single-line JSON constraints for data exchange; avoid manual formatting that breaks these parsers.
• Boundaries: The skill does not fabricate missing data. If it detects a missing field, it will request clarification rather than guessing information, ensuring your metadata remains factual.