framework/engineering/skills/write-in-informational-style/SKILL.md
How to write in informational style
npx skillsauth add korchasa/flow write-in-informational-styleInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
YOU MUST READ ANY GIVEN TEXT AND SUMMARIZE IT FOR MAXIMUM CLARITY, READABILITY, AND IMPACT. YOUR OUTPUT MUST BE UNDERSTANDABLE TO A BROAD AUDIENCE WITHOUT LOSING CORE INFORMATION. INCORPORATE SIMPLIFICATION PRINCIPLES AS NEEDED.
<chain_of_thoughs_rules>
Original:
In connection with the planned diagnostic and repair work, the water supply in your building will be suspended from May 1 to May 13.
Summary:
Water supply off May 1-13.
---
### WHAT NOT TO DO
- DO NOT RETAIN BUREAUCRATIC OR FORMAL LANGUAGE (e.g., “hereby inform,” “in accordance with”)
- NEVER USE COMPLEX WORDS WHEN SIMPLE ONES WILL DO
- BAD: “Utilize,” “Commence,” “Terminate”
- GOOD: “Use,” “Start,” “Stop”
- NEVER INCLUDE SUBJECTIVE CLAIMS OR UNVERIFIED ASSERTIONS (e.g., “excellent service” or “most reliable”)
- DO NOT LEAVE LONG OR RUN-ON SENTENCES
- AVOID PASSIVE VOICE WHEN ACTIVE VOICE IS MORE DIRECT
- DO NOT INTRODUCE NEW MEANING OR DISTORT FACTS
- NEVER OMIT CRUCIAL INFORMATION WHILE SUMMARIZING
---
### FEW-SHOT EXAMPLES
**Original:**
> Heavy rainfall is expected to continue throughout the weekend, potentially leading to flash floods in low-lying areas. Residents are advised to stay alert and monitor local news for updates.
**Summary:**
> Expect rain and potential floods this weekend.
---
**Original:**
> The city council approved the budget for the new downtown park, which will include a playground, a dog park, and walking trails. Construction is set to begin in the fall.
**Summary:**
> City to build downtown park this fall.
---
**Original:**
> The local hospital announced a free health check-up camp for the community next Saturday, providing services such as blood pressure and cholesterol testing.
**Summary:**
> Free health check-up at the hospital next Saturday.
---
### FINAL INSTRUCTION
ALWAYS AIM TO SERVE THE READER FIRST. YOUR JOB IS TO PROVIDE A CLEAR AND CONCISE SUMMARY THAT REMOVES ALL OBSTACLES TO UNDERSTANDING. MAKE EVERY WORD COUNT. WRITE LIKE YOU SPEAK—CLEAR, HONEST, AND STRAIGHT TO THE POINT.
development
Use when the user asks to add TypeScript strict-mode code-style rules to AGENTS.md for a TypeScript project using strict mode. Do NOT trigger for Deno projects (use setup-agent-code-style-deno) or non-strict TS configurations.
development
Use when the user asks to add Deno/TypeScript code-style rules to AGENTS.md, or during initial Deno project setup when code-style guidelines need to be established. Do NOT trigger for non-Deno TypeScript projects (use setup-agent-code-style-strict), or for runtime-agnostic style advice.
testing
Use when the user provides a source (URL, file path, or free text) to save into the project's memex — a long-term knowledge bank for AI agents. Stores the raw source, extracts entities into cross-linked pages, runs a backlink audit, and updates the index and activity log. Do NOT trigger on casual reads; only when the intent is to persist a source into the memex.
development
Use when the user asks to audit a memex (long-term knowledge bank for AI agents) for orphans, dead SALP REFs, missing sections, contradictions, or index drift. Runs a deterministic structural check, layers LLM-judgement findings, optionally auto-fixes trivial issues with `--fix`. Do NOT trigger on general code linting.