preflight-new-skill

Audit SKILL.md files for frontmatter, style, leaks, and publication readiness.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/subimagesec/skills --skill preflight-new-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: preflight-new-skill
Source: https://github.com/subimagesec/skills/tree/main/.agents/skills/preflight-new-skill
Command: npx skills add https://github.com/subimagesec/skills --skill preflight-new-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps verify that a newly added or modified skill is ready for publication by checking its content, safety, and discoverability before a pull request is opened.

Core Features & Use Cases

  • Frontmatter Validation: Confirms the skill name, description, and overall file shape are correct.
  • Safety and Quality Checks: Scans for placeholder text, style issues, leaks, and redundant prerequisites.
  • Repo Publication Readiness: Verifies that required repository surfaces and MCP tool references stay in sync.
  • Use Case: A reviewer can quickly determine whether a new marketplace skill is complete, public-safe, and ready to ship.

Quick Start

Ask the skill to audit the newly added or modified skill on the current branch and report every issue with exact file and line fixes before you open a pull request.

Frequently Asked Questions about preflight-new-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit a new skill for publication readiness before opening a PR?

Audit a newly added or modified skill for publication readiness by scanning frontmatter correctness, style compliance, leak risks, and MCP tool references. The skill produces exact file and line fixes plus a pass/fail summary for each checkpoint before you open a pull request.

What is skill frontmatter validation and why does it matter for marketplace repositories?

Skill frontmatter validation confirms the skill name, description, and overall file shape are correct. It ensures marketplace repositories pass repository-specific validation and discoverability checks, preventing incomplete or malformed skill files from shipping.

How do I check my SKILL.md files for security leaks and style compliance?

Check SKILL.md files for security leaks and style compliance by running a preflight audit that scans for placeholder text, leak risks, redundant prerequisites, and style issues. The audit outputs exact file and line fixes for each detected problem.

Can I use a preflight skill audit to verify MCP tool references in my repository?

Yes, you can use a preflight skill audit to verify MCP tool references. It cross-checks required repository surfaces and MCP tool references to ensure they stay in sync, returning a pass or fail summary for each checkpoint.

What's the best way to ensure repository review success for newly added marketplace skills?

Ensure repository review success by running a preflight audit to validate frontmatter, safety, quality, and discoverability. This allows a reviewer to quickly determine whether a new marketplace skill is complete, public-safe, and ready to ship.

Why does my new skill fail repository validation before publication?

A new skill fails repository validation due to incorrect frontmatter, placeholder text, style issues, leak risks, or out-of-sync MCP tool references. A preflight audit identifies these exact issues with file and line fixes to resolve the failures.