# Technical Writing

> >

- **Type:** Skill
- **Install:** `agentstack add skill-nice3point-revit-skills-technical-writing`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Nice3point](https://agentstack.voostack.com/s/nice3point)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Nice3point](https://github.com/Nice3point)
- **Source:** https://github.com/Nice3point/revit-skills/tree/main/plugins/dotnet/skills/technical-writing

## Install

```sh
agentstack add skill-nice3point-revit-skills-technical-writing
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Technical Writing

Open with the fact the reader needs, describe observable behavior, and cut anything a reader can already infer.

## Write

1. Identify the reader and the decision or behavior the text must make clear.
2. Open with the fact the reader needs.
3. Describe the observable contract rather than its current implementation.
4. Link the authoritative local source when a value, schema, or API may change.
5. Remove every statement a reader can infer from the code, heading, or surrounding text.

## Apply

- Use plain technical English and third-person present indicative in reference prose.
- Write one sentence per line; keep one idea per sentence.
- Use headings that name the subject; use a colon in a heading that introduces a variant or qualifier.
- Use a list only when the reader must act on, compare, or remember several items.
- State a negative only when a competent reader would otherwise make a plausible, harmful assumption.
- Link instead of copying a maintained list of identifiers or values.
- Avoid corporate language, filler, meta-preambles, and trailing "including…" examples.

## Review

- [ ] The first sentence states the substantive fact.
- [ ] The text describes behavior, not implementation mechanics.
- [ ] Each sentence adds information a reader cannot infer.
- [ ] The authoritative source stays linked where a contract is restated.
- [ ] Prose follows one-sentence-per-line formatting.

## Common Pitfalls

| Pitfall                                                 | Correct approach                     |
|---------------------------------------------------------|--------------------------------------|
| A preamble before the point ("This section describes…") | Lead with the fact the reader needs. |
| Copying a list of constants or endpoints into prose     | Link the authoritative source.       |
| Restating the heading in the first sentence             | Add new information instead.         |
| Documenting how the code works today                    | Document the observable contract.    |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Nice3point](https://github.com/Nice3point)
- **Source:** [Nice3point/revit-skills](https://github.com/Nice3point/revit-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-nice3point-revit-skills-technical-writing
- Seller: https://agentstack.voostack.com/s/nice3point
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.