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

常见问题

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.