writing-skills

Guide agent skill creation and testing with Test-Driven Development principles.

Updated Aug 21, 2021
One-click install
npx skills add https://github.com/saint2706/Coding-For-MBA --skill writing-skills-saint2706
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/saint2706/Coding-For-MBA/tree/main/.agents/skills/writing-skills
Command: npx skills add https://github.com/saint2706/Coding-For-MBA --skill writing-skills-saint2706

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that new and updated agent skills are robust, effective, and adhere to best practices by applying Test-Driven Development (TDD) principles to the skill creation and documentation process. It prevents the deployment of untested or poorly documented skills.

Core Features & Use Cases

  • TDD for Skills: Enforces the RED-GREEN-REFACTOR cycle for skill development.
  • Pressure Testing: Provides methodologies to test skills under realistic constraints (time, sunk cost, authority) to identify rationalizations and loopholes.
  • Bulletproofing: Guides on how to close loopholes and make skills resistant to common excuses for non-compliance.
  • Use Case: Before deploying a new skill that enforces a critical coding standard, you would use this skill's testing methodology to simulate scenarios where an agent might be tempted to bypass the standard, ensuring the skill prevents such deviations.

Quick Start

Use the writing-skills skill to guide the creation and testing of a new agent skill, ensuring it follows TDD principles.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I apply TDD principles to agent skill development?

To apply TDD to agent skill development, follow the RED-GREEN-REFACTOR cycle: write failing baseline tests, develop minimal skills for compliance, and refactor to close loopholes under pressure. This enforces discipline and prevents rationalizations for non-compliance.

What is the best way to pressure test agent skills against non-compliance?

Pressure test agent skills by simulating realistic constraints such as time, sunk cost, and authority. This methodology identifies rationalizations and loopholes, allowing you to bulletproof skills and prevent deviations from critical coding standards.

How do you write tests that prevent an AI agent from bypassing coding standards?

To prevent an AI agent from bypassing coding standards, write failing baseline tests that simulate scenarios where an agent might be tempted to deviate. Then develop minimal skills to enforce compliance and close loopholes against common excuses.

When do I need to use TDD for skill documentation and creation?

Use TDD for skill documentation and creation before deploying new or updated agent skills that enforce critical standards. It ensures skills are robust, effective, and adheres to best practices, preventing the deployment of untested or poorly documented skills.

Can I use refactoring to close loopholes in discipline-enforcing skills?

Yes, you can use refactoring to close loopholes in discipline-enforcing skills. The TDD cycle utilizes refactoring specifically to tighten skills under pressure, making them resistant to common excuses and rationalizations for non-compliance with established standards.

Why do agent skills fail to enforce compliance under realistic constraints?

Agent skills fail to enforce compliance under realistic constraints due to rationalizations and loopholes related to time, sunk cost, and authority. Without pressure testing and bulletproofing, agents can find excuses to bypass critical coding standards.