kienbui1995/writing-skills
skills/writing-skills/SKILL.md
Use when creating new skills, editing existing skills, or verifying skills work before deployment
testing
Updated Apr 24, 2026
$ install --global
skillsauthnpx skillsauth add kienbui1995/magic-powers writing-skillsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 24, 2026, 4:25 AM148.5s1 file scanned
SKILL.md
- name:
- writing-skills
- description:
- Use when creating new skills, editing existing skills, or verifying skills work before deployment
Writing Skills
Overview
Writing skills IS Test-Driven Development applied to process documentation.
Write test cases (pressure scenarios with subagents), watch them fail (baseline behavior), write the skill, watch tests pass (agents comply), refactor (close loopholes).
Core principle: If you didn't watch an agent fail without the skill, you don't know if the skill teaches the right thing.
What is a Skill?
A skill is a reference guide for proven techniques, patterns, or tools.
Skills are: Reusable techniques, patterns, tools, reference guides. Skills are NOT: Narratives about how you solved a problem once.
Skill File Format
---
name: my-skill-name
description: When to use this skill - triggers automatic activation
---
# Skill Title
## Overview
What this skill teaches and why.
## When to Use
Specific triggers.
## The Process
Step-by-step instructions.
## Integration
Related skills.
TDD for Skills
RED: Write a Pressure Test
Create a scenario that tests whether an agent follows the desired behavior WITHOUT the skill.
claude -p "Fix this failing test" --model haiku
# Observe: Does it investigate root cause? Or just guess?
GREEN: Write the Skill
Write SKILL.md that teaches the behavior you want.
REFACTOR: Close Loopholes
Test edge cases. Agents will find creative ways to skip steps. Add guardrails.
Key Principles
- Description is the trigger — write it carefully, it determines when the skill activates
- Be specific — vague instructions get vague compliance
- Include anti-patterns — show what NOT to do
- Test with subagents — they're the harshest test of skill clarity
- Keep it focused — one skill, one topic
Skill Locations
- Plugin skills:
skills/<name>/SKILL.md(distributed with plugin) - User skills:
~/.claude/skills/<name>/SKILL.md(personal) - Project skills:
.claude/skills/<name>/SKILL.md(per-project)
Related Skills
kienbui1995/xr-interface-design
content-media
VerifiedTrustedCommunity
Use when designing for XR (AR/VR/MR), choosing interaction modes, or adapting 2D UI patterns for spatial computing
SKILL.mdUpdated Apr 24, 2026
kienbui1995/writing-plans
development
VerifiedTrustedCommunity
Use when you have a spec or requirements for a multi-step task, before touching code
SKILL.mdUpdated Apr 24, 2026
kienbui1995/workflow-templates
development
VerifiedTrustedCommunity
Use when executing a structured workflow — select and run a feature, bugfix, refactor, research, or incident template with correct agent and model assignments per phase.
SKILL.mdUpdated Apr 24, 2026
kienbui1995/visionos-patterns
development
VerifiedTrustedCommunity
Use when designing for Apple visionOS, applying spatial design conventions, or building for the Apple Vision Pro platform
SKILL.mdUpdated Apr 24, 2026