fix-common-issues

Automatically repairs mechanical validation issues in Claude Code plugin files with user confirmation.

1|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/JaviMontano/mao-plugin-qa --skill fix-common-issues-javimontano
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fix-common-issues
Source: https://github.com/JaviMontano/mao-plugin-qa/tree/main/skills/fix-common-issues
Command: npx skills add https://github.com/JaviMontano/mao-plugin-qa --skill fix-common-issues-javimontano

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Plugin validation often surfaces dozens of small mechanical issues—trailing commas in JSON, missing shebangs, non-executable scripts, incomplete frontmatter—that are tedious to fix by hand. This Skill detects and repairs those issues automatically while keeping you in control of every change. ## Core Features & Use Cases - JSON Repair: Detects and fixes trailing commas and syntax errors in plugin.json and hooks.json, then verifies the result parses cleanly. - Script Fixes: Adds missing #!/bin/bash shebangs and applies chmod +x to shell scripts in scripts/ and hooks/ directories. - Frontmatter Completion: Fills in missing name, description, and allowed-tools fields in SKILL.md files using sensible defaults derived from directory names. - Hook Type Conversion: Converts incompatible type: "prompt" hooks to type: "command" on non-ToolUseContext events, preserving the original prompt as a comment. - Use Case: After running a plugin audit that reports 15 warnings, invoke this Skill to preview each proposed fix with before/after diffs, approve them selectively, and re-validate to confirm resolution. ## Quick Start Fix the common issues found during validation of my plugin, showing me each proposed change before applying it.

Frequently Asked Questions about fix-common-issues

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

FAQPage Schema
How do I automatically fix plugin validation issues in Claude Code?▼

Run the fix-common-issues skill after a validation audit. It inventories fixable mechanical issues, shows a numbered before/after preview of each proposed change, and applies only the fixes you approve, then re-validates the modified files.

What issues can be auto-fixed in a Claude Code plugin?▼

Auto-fixable issues include JSON trailing commas, missing bash shebangs, missing execute permissions on .sh scripts, missing frontmatter fields in SKILL.md, empty hook event arrays, missing alias-of fields, and a missing agent key in settings.json.

Does auto-fix modify files without asking for confirmation?▼

No. Every proposed fix is presented as a numbered list with file path, before/after summary, and category, and the skill stops until you explicitly approve. You can approve all fixes, select specific numbers, or reject everything.

Can auto-fix repair semantic or content quality problems in plugins?▼

No. It only handles mechanical issues like syntax and permissions. Vague descriptions, poorly ordered procedures, security vulnerabilities, and orphaned skills require human judgment and are reported as manual-fix items.

What happens if an auto-fix breaks a file?▼

Each fix is verified immediately after application, such as parsing JSON to confirm validity. Fixes that fail verification are reported, but there is no built-in undo, so reverting requires manual action such as git restore.