ADHD-Friendly ASD-STE100 Technical Writer

skills.sh Validate skill

Write technical documentation that is precise, easy to scan, and easier to resume after interruption.

This Agent Skill combines ASD-STE100-inspired technical-writing discipline with explicitly labeled ADHD-friendly house rules. It helps an agent produce tutorials, setup guides, runbooks, manuals, and engineering procedures with lower working-memory demand.

What this skill does

  • States the goal before background information.
  • Makes prerequisites and the required path explicit.
  • Uses one action per numbered step or line.
  • Keeps procedural sentences at 20 words or fewer.
  • Keeps descriptive sentences at 25 words or fewer.
  • Targets 8–15 words per sentence when practical.
  • Places conditions before dependent actions.
  • Repeats important file names, settings, and nouns when needed.
  • Separates required steps from optional details.
  • Shows observable results after important actions.
  • Provides symptom, cause, and solution for recovery paths.
  • Adds progress markers to long procedures.

Scope and boundaries

The skill is an editorial workflow. It does not certify a document as ASD-STE100 compliant.

The sentence ceilings, controlled vocabulary, and condition-first rules are STE-inspired. The lower-memory targets, resumability rules, progress markers, and observable-result emphasis are recommended house rules. Do not present these additions as official ADHD or ASD-STE100 requirements.

The skill does not replace:

  • Domain, safety, legal, or security review.
  • Accessibility testing with people who use the content.
  • Verification of commands, versions, paths, or expected output.
  • An authorized ASD-STE100 review or certification process.

Install

Any supported Agent Skills client

npx skills add mshojaei77/adhd-friendly-ste-technical-writer

The repository contains one skill. The install command discovers the SKILL.md under skills/adhd-friendly-ste-technical-writer/.

Hermes Agent

Add the repository as a custom tap:

hermes skills tap add mshojaei77/adhd-friendly-ste-technical-writer
hermes skills search adhd-friendly --source mshojaei77/adhd-friendly-ste-technical-writer
hermes skills install mshojaei77/adhd-friendly-ste-technical-writer/adhd-friendly-ste-technical-writer

Or install the skill directly from GitHub:

hermes skills install mshojaei77/adhd-friendly-ste-technical-writer/adhd-friendly-ste-technical-writer

Review a third-party skill before installing it in a trusted agent environment.

Use it

Ask for the documentation task directly. Examples:

Rewrite this deployment guide for lower working-memory demand.
Keep the commands unchanged. Add expected results and recovery steps.

Write a setup guide for this repository.
Use a goal-first structure, explicit prerequisites, and resumable steps.

Review this runbook against the ADHD-friendly ASD-STE100-inspired checklist.
List critical problems first, then provide corrected wording.

For reliable results, provide the intended reader, task, successful end state, and verified technical details.

Repository layout

.
├── README.md
├── CHANGELOG.md
├── LICENSE
├── skills.sh.json
├── scripts/
│   └── validate_skill.py
└── skills/
    └── adhd-friendly-ste-technical-writer/
        ├── SKILL.md
        └── references/
            └── source-basis.md

The main SKILL.md stays focused on the workflow. Source provenance remains in references/source-basis.md so it can be loaded only when exact claims need checking.

Validate locally

Run the repository validator from the repository root:

uv run --no-project python scripts/validate_skill.py

Expected result:

Validated skills/adhd-friendly-ste-technical-writer/SKILL.md

You can also test installation discovery with the Skills CLI:

npx skills add . --skill adhd-friendly-ste-technical-writer

Source basis

The bundled source-basis reference records which claims are official, which are recommendations, and which require fresh verification.

Versioning

This repository follows semantic versioning for the skill. See CHANGELOG.md for release history.

License

MIT. See LICENSE.