writing-skills

writing-skills: 이 Skill이 하는 일

writing-skills is a reusable agent skill listed on skills.sh under obra/superpowers. skills.sh rank #174, installs 67.6K, GitHub stars 204.9K, first seen Jan 19, 2026.

Test-driven documentation for creating reusable agent techniques, patterns, and reference guides. Write failing test scenarios first (baseline agent behavior without skill), then write minimal skill documentation to address specific violations, following RED-GREEN-REFACTOR cycle Skills live in agent-specific directories and must include YAML frontmatter (name, description), overview, core patterns, quick reference, and common mistakes sections Description field must start with "Use when..." and list only triggering conditions—never summarize workflow, as Claude may follow description instead of reading full skill content Requires understanding superpowers:test-driven-development; discipline-enforcing skills need explicit loophole closures and rationalization tables to resist workarounds under pressure Keep getting-started skills under 150 words, other frequently-loaded skills under 200 w

사용하기 좋은 상황

• Use this skill when the task matches the package name, repository context, or skills.sh topic: agent-workflow.
• Prefer it when a repeatable workflow is better than a one-off prompt: setup, review, design, deployment, automation, research, media generation, or operational checks.
• For production work, read the linked repository and install command before allowing the agent to run scripts or modify files.

Agent 사용 방식

1. Confirm the user intent and whether this skill is the right fit.
2. Install or inspect the skill with the official command from skills.sh.
3. Read the local SKILL.md and only load extra files referenced by that skill.
4. Follow the skill's workflow, then verify the result with tests, screenshots, audits, or source-backed checks as appropriate.
5. Record any constraints, missing credentials, tool permissions, or security warnings before handoff.

품질 및 안전 점검

• Check repository ownership and source reputation: obra/superpowers.
• Review security audit signals before installing; skills.sh reports: Gen Agent Trust Hub Pass Socket Pass Snyk Pass.
• Never grant broad shell, browser, cloud, or deployment permissions without user approval.
• Treat generated output as draft until validated by the skill's own acceptance criteria.
• If the skill touches cloud resources, costs, credentials, customer data, or production deploys, require a human review step.

출처와 설치

• skills.sh page: https://www.skills.sh/obra/superpowers/writing-skills
• Repository: https://github.com/obra/superpowers
• Install command: npx skills add https://github.com/obra/superpowers --skill writing-skills

FAQ

Is writing-skills an agent, a prompt, or a skill?
It is a skill: a reusable package of task-specific instructions and supporting files that an agent can load when the user's request matches the workflow.

Should I install it automatically?
Only after checking the repository, install command, audit status, and whether the user wants this capability in the current agent environment.

What makes it useful for AIDreamHub users?
It helps users discover practical agent capabilities from the open skills ecosystem and compare them by task, source, install count, and operational risk.