skill-authoring

Guide AI skill creation with risk-based testing and discoverability optimization.

Updated Nov 4, 2025
One-click install
npx skills add https://github.com/netzkontrast/aegis --skill skill-authoring-netzkontrast
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-authoring
Source: https://github.com/netzkontrast/aegis/tree/main/skills/skill-authoring
Command: npx skills add https://github.com/netzkontrast/aegis --skill skill-authoring-netzkontrast

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured framework to ensure new and updated skills are created with appropriate rigor, testing, and discoverability, preventing common pitfalls and improving overall quality.

Core Features & Use Cases

  • Risk-Based Testing: Guides you to apply testing rigor proportional to the skill's risk level, from light checks to full TDD.
  • CSO Optimization: Provides clear formulas and examples for optimizing skill discoverability through precise naming and descriptions.
  • Ethical Persuasion: Offers guidance on using persuasion principles responsibly and effectively.
  • Use Case: When creating a new skill that enforces a critical process, use this Skill to follow the TDD cycle, define clear red flags, and optimize its description for Claude's search.

Quick Start

Use the skill-authoring skill to determine the appropriate testing rigor for a new skill.

Frequently Asked Questions about skill-authoring

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

FAQPage Schema
How do I apply risk-based testing when authoring AI skills?

Risk-based testing applies testing rigor proportional to a skill's risk level, guiding you from light checks to full TDD cycles. This framework ensures new skills are created with appropriate rigor, preventing common failure modes like insufficient testing.

What is CSO optimization and how does it improve skill discoverability?

CSO optimization improves skill discoverability through precise naming conventions and clear descriptions. It provides specific formulas and examples to optimize your skill's metadata, ensuring Claude's search can effectively locate and surface your skill.

How do I use ethical persuasion principles in skill development?

Ethical persuasion in skill development involves using persuasion principles responsibly and effectively. The framework offers guidance on avoiding manipulative language while optimizing your skill's communication, addressing common failure modes related to manipulative wording.

What's the best way to structure the entire skill lifecycle from concept to validation?

The best way to structure the skill lifecycle is using a framework that supports the entire process from initial concept to validation and iteration. This includes defining clear red flags, following TDD cycles for critical processes, and optimizing descriptions for search.

Can I use test-driven development for skills that enforce critical processes?

Yes, you can use test-driven development for skills enforcing critical processes. The framework guides you through the TDD cycle, helps define clear red flags for failure modes, and ensures appropriate testing rigor proportional to the skill's risk level.

Why do my AI skills fail due to poor naming conventions and insufficient testing?

AI skills fail due to poor naming conventions and insufficient testing because these are common failure modes in skill development. The framework addresses these issues by enforcing risk-based testing methodology and CSO optimization for discoverability.