skill-auditor

Audit BlueStack skill units for frontmatter completeness, location, and reference integrity.

Updated Aug 27, 2026

Search Tags:#audit #skills #quality #conventions #frontmatter #references

Ready to run

npx skills add https://github.com/JuantoC/BlueStack-Test-Automation-Framework --skill skill-auditor-juantoc

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-auditor
Source: https://github.com/JuantoC/BlueStack-Test-Automation-Framework/tree/main/.claude/skills/skill-auditor
Command: npx skills add https://github.com/JuantoC/BlueStack-Test-Automation-Framework --skill skill-auditor-juantoc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This audit skill identifies and reports deviations from the BlueStack skill conventions in .claude/skills and .claude/pipelines, including missing frontmatter fields, incorrect locations, broken references, and stale orphaned references, enabling teams to improve quality and consistency.

Core Features & Use Cases

Static verification of frontmatter fields (name, model, effort, description)
Location and type validation for skills vs pipelines
Integrity checks for references and wiki links
Cross-skill consistency checks (redirects, trigger phrases overlap)
Consolidated, structured reporting of issues with severities
Optional guidance for fixes or escalation paths to other roles

Quick Start

Run the skill-auditor against your .claude/skills directory to generate a report of issues and recommendations.

Frequently Asked Questions about skill-auditor

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

FAQPage Schema

How do I check BlueStack skills for missing frontmatter fields?▼

Check BlueStack skills for missing frontmatter by running an audit that statically verifies required metadata fields like name, model, effort, and description, producing a structured report of completeness issues.

What is the best way to validate references and wiki links in .claude/skills directories?▼

Validate references in .claude/skills directories using an audit tool that checks reference integrity, identifies broken links, and flags stale orphaned references for remediation.

How do I detect trigger phrase overlap across multiple skills?▼

Detect trigger phrase overlap across multiple skills by running a cross-skill consistency check that scans for overlapping triggers and redirect conflicts, generating a prioritized report of consistency issues.

Does the skill audit support escalation when fixes require human decision?▼

The skill audit supports escalation when fixes require human decision, providing optional guidance for fixes and defining escalation paths to other roles when domain knowledge is needed for remediation.

Can I verify correct file locations for skills versus pipelines in .claude directories?▼

Verify correct file locations for skills versus pipelines in .claude directories through an audit that performs location and type validation, ensuring skills and pipelines conform to BlueStack conventions.

Why does my skill audit report show stale orphaned references?▼

A skill audit report shows stale orphaned references because the audit identifies references that no longer point to valid targets, flagging them as deviations from BlueStack conventions requiring remediation.