skill-debugging-assistant

Diagnose skill activation failures across triggers, frontmatter, and packaging structure.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Alejfanjul/ai-brain --skill skill-debugging-assistant-alejfanjul
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-debugging-assistant
Source: https://github.com/Alejfanjul/ai-brain/tree/main/sources/claude-meta-skills/skill-debugging-assistant
Command: npx skills add https://github.com/Alejfanjul/ai-brain --skill skill-debugging-assistant-alejfanjul

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose why skills fail to activate or misbehave, by analyzing triggers, frontmatter, and instruction hierarchy to surface root causes.

Core Features & Use Cases

  • Comprehensive trigger diagnostics: identify missing or ambiguous triggers, overlapping descriptions, and misaligned prompts.
  • Structure and safety validation: verify YAML frontmatter, token budget, and progressive disclosure compliance.
  • Remediation guidance: propose concrete fixes with actionable steps and reference material, enabling rapid repairs in production skills.

Quick Start

Run the diagnostic workflow on a failing skill to identify trigger, description, and structure issues and generate a remediation plan.

Frequently Asked Questions about skill-debugging-assistant

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

FAQPage Schema
Why does my AI skill fail to activate when expected triggers are present?

Skill activation fails when triggers are missing, ambiguous, or overlap with other descriptions. Diagnose trigger misalignment, analyze prompt interactions, and resolve instruction conflicts to ensure reliable skill activation.

How do I debug YAML frontmatter issues in my skill package?

Debug YAML frontmatter by validating structure, verifying token budget limits, and checking progressive disclosure compliance. Analyze packaging structure to identify root causes and apply concrete edits to ensure reliable activation.

What is the best way to fix false positives in skill trigger matching?

Fix false positives by running comprehensive trigger diagnostics to identify overlapping descriptions and misaligned prompts. Apply structured remediation steps and concrete edits to SKILL.md to resolve unnecessary skill activations.

How do I validate progressive disclosure and token budget limits for skills?

Validate progressive disclosure and token budget limits by analyzing packaging structure and YAML frontmatter compliance. Generate structured recommendations and remediation steps to ensure reference loading adheres to budget constraints.

Can I diagnose prompt injection and instruction conflicts in skill definitions?

Diagnose prompt injection and instruction conflicts by analyzing prompt interactions and instruction hierarchy within skills. Surface root causes of misbehavior and apply concrete fixes to references and scripts for secure packaging.

What should I do when skill troubleshooting does not resolve reference loading failures?

When troubleshooting does not resolve reference loading failures, analyze token budget constraints and progressive disclosure compliance. Review SKILL.md edits and scripts to identify structural limitations and apply remediation guidance.