Where does Skill QC look for files to audit?

It intelligently searches for editable source files in plugin repos, home skill directories, or project-local paths, avoiding read-only cache files.

Why is portability important for Claude Code skills?

Portable skills can be shared across teams and different projects without breaking due to hardcoded user directories or environment-specific configurations.

What is a Claude Code Skill QC audit?

It is a systematic check against 10 specific generalization patterns to ensure a skill is portable, secure, and follows architectural best practices for Claude Code.

Does it check for security vulnerabilities?

The audit includes a specific check (P08) for externalized secrets, ensuring that API keys, tokens, or passwords are not hardcoded within the skill files.

Can this tool fix issues automatically?

Yes, Skill QC can identify issues and, upon user confirmation, automatically apply fixes for many common portability failures like path relative-ization.

Skill Quality Control

Name: Skill Quality Control
Author: AI-Builder-Team

byAI-Builder-Team

•

開発者ツール

Audits and fixes Claude Code skills to ensure portability, generalization, and compliance with architectural best practices.

Skill QC is a specialized utility designed for developers building and maintaining Claude Code extensions. It performs a comprehensive 10-point 'Generalization Audit' to identify critical issues such as hardcoded system paths, project-specific naming leaks, and hidden environment dependencies. By ensuring skills are self-contained, idempotent, and environment-aware, this tool helps developers create high-quality, portable plugins that function seamlessly across different machines, repositories, and user configurations.

主な機能

01Automated fix application for common portability failures and WARN items

02Identification of project-specific naming in generic utility strings

03Automated detection of hardcoded user paths and absolute file references

042 GitHub stars

05Security check for hardcoded secrets, API keys, and credentials

0610-point portability and generalization audit framework

ユースケース

01Preparing a locally developed Claude Code skill for publication to a shared marketplace

02Debugging a skill that works on a lead developer's machine but fails in CI/CD or other environments

03Refactoring legacy skills to move logic from SKILL.md into externalized, testable scripts

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ai-builder-team/ai-builder-plugin-marketplace skill-qc

For use in Claude.ai and ChatGPT

主な機能

01Automated fix application for common portability failures and WARN items

02Identification of project-specific naming in generic utility strings

03Automated detection of hardcoded user paths and absolute file references

042 GitHub stars

05Security check for hardcoded secrets, API keys, and credentials

0610-point portability and generalization audit framework

ユースケース

01Preparing a locally developed Claude Code skill for publication to a shared marketplace

02Debugging a skill that works on a lead developer's machine but fails in CI/CD or other environments

03Refactoring legacy skills to move logic from SKILL.md into externalized, testable scripts

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ai-builder-team/ai-builder-plugin-marketplace skill-qc

For use in Claude.ai and ChatGPT