skill-enhancer

Audit and enhance agent skills for TDD, CSO, and Script-First compliance.

4|Updated Dec 17, 2025
One-click install
npx skills add https://github.com/MatrixFounder/Agentic-development --skill skill-enhancer-matrixfounder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-enhancer
Source: https://github.com/MatrixFounder/Agentic-development/tree/main/.agent/skills/skill-enhancer
Command: npx skills add https://github.com/MatrixFounder/Agentic-development --skill skill-enhancer-matrixfounder

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenge of ensuring agent skills meet high standards for reliability, security, and efficiency, preventing common rationalizations and errors.

Core Features & Use Cases

  • Automated Auditing: Detects structural, language, and policy gaps in existing skills using analyze_gaps.py.
  • Targeted Refactoring: Guides agents through fixing identified issues based on best practices.
  • Use Case: You have a newly developed skill that passes basic tests but might be prone to errors or security vulnerabilities. Run skill-enhancer to audit and upgrade it before deployment.

Quick Start

Run the skill enhancer to audit the skill located at '../target-skill'.

Frequently Asked Questions about skill-enhancer

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

FAQPage Schema
How do I audit agent skills for compliance with TDD and Script-First standards?

You can audit agent skills for compliance by running the skill-enhancer tool, which uses `analyze_gaps.py` to automatically detect structural, language, and execution policy gaps. It then provides targeted refactoring patterns to guide remediation and achieve a Gold Standard.

What is the best way to refactor existing agent skills to prevent security vulnerabilities?

The best way to refactor agent skills for security and reliability is to run an automated audit that identifies execution policy gaps. This process detects structural vulnerabilities and provides specific refactoring patterns to manually or automatically upgrade the skill before deployment.

Does the skill auditing process require specific dependencies or environments to run?

Yes, the skill auditing process requires Python3 as its primary dependency. You must have Python3 installed in your environment to execute the `analyze_gaps.py` script and perform the automated detection of structural and policy gaps in your agent skills.

Can I use this tool to upgrade a newly developed skill that passes basic tests?

Yes, you can use this tool to upgrade newly developed skills that pass basic tests but might be prone to errors. Running the skill enhancer audits the skill against TDD, CSO, and Script-First standards, identifying hidden vulnerabilities and guiding remediation before deployment.

Why does my agent skill fail to meet CSO standards during automated auditing?

Agent skills fail to meet CSO standards during auditing when the `analyze_gaps.py` script detects structural, language, or execution policy gaps. The tool identifies these specific compliance failures and provides targeted refactoring patterns to guide the necessary manual or automated upgrades.

When should I not use automated skill enhancement for refactoring agent code?

You should not rely solely on automated skill enhancement when your agent code requires complex, domain-specific logic that automated refactoring patterns cannot fully contextualize. In these cases, use the audit results to guide manual remediation rather than applying automated upgrades blindly.