writing-science-skills
Use when creating new skills, editing existing skills, or verifying skills work before deployment
npx skills add K-Dense-AI/science-superpowers --skill writing-science-skills --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Writing Science Skills ## Overview **Writing a skill is an experiment, not an essay.** You form a hypothesis (this guidance will change agent behavior), run a baseline (watch agents fail without it), write the skill, and test that behavior changes. **Core principle:** If you didn't watch an agent fail without the skill, you don't know whether the skill teaches the right thing — the same reason you pre-register before analyzing rather than rationalizing a result after. **REQUIRED BACKGROUND:** Understand `science-superpowers:preregistering-analysis` first. The discipline of fixing a prediction before observing the outcome is exactly the discipline here: observe baseline behavior before writing the skill, so the skill is shaped by evidence, not by what you imagine agents do. ## What is a Skill? A **skill** is a reference guide for a proven technique, pattern, or discipline that future agents can find and apply. **Skills are:** reusable techniques, patterns, disciplines, reference guides. **Skills are NOT:** narratives about how you did something once. ## The Empirical Mapping | Experiment concept | Skill creation | |--------------------|----------------| | Hypothesis | "This guidan
- Overview
- What is a Skill?
- The Empirical Mapping
- When to Create a Skill
- Skill Types
- Directory Structure
- SKILL.md Structure
- Description = When to Use, NOT What the Skill Does
- Claude Search Optimization (CSO)
- Cross-Referencing Other Skills
- Flowchart Usage
- Code & Examples
- The Iron Law
- Testing All Skill Types
What does the writing-science-skills skill do?
Use when creating new skills, editing existing skills, or verifying skills work before deployment
How do I install it?
Run `npx skills add K-Dense-AI/science-superpowers --skill writing-science-skills --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From K-Dense-AI/science-superpowers, a repository with 280 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.