CtrlK
BlogDocsLog inGet started
Tessl Logo

write-in-informational-style

Rewrite text in a dense, factual informational style with no fluff or marketing. Use when the user asks to write or rewrite docs or notes concisely or to apply a neutral informational tone.

56

Quality

62%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/flowai-engineering/skills/write-in-informational-style/SKILL.md
SKILL.md
Quality
Evals
Security

HOW TO WRITE IN INFORMATIONAL STYLE

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.

YOU MUST FOLLOW THIS CHAIN OF THOUGHT BEFORE PRODUCING THE SUMMARY

<chain_of_thoughs_rules>

  1. UNDERSTAND: IDENTIFY the MAIN IDEA and PURPOSE of the original text. ASK: “WHAT DOES THE READER NEED TO KNOW?”
  2. BASICS: DETERMINE what INFORMATION IS ESSENTIAL for the READER. FOCUS on FACTS, ACTIONS, and OUTCOMES.
  3. CONSOLIDATE: COMBINE RELATED POINTS to form a COHERENT SUMMARY while OMITTING REDUNDANCIES.
  4. SIMPLIFY: ENSURE YOUR SUMMARY USES SIMPLE, SHORT, AND FAMILIAR WORDS. REPLACE COMPLEX EXPRESSIONS with CLEAR, CONCRETE ONES.
  5. BUILD: ORGANIZE the SUMMARY into SHORT SENTENCES and CLEAR PARAGRAPHS. USE BULLETS or HEADINGS if helpful.
  6. EDGE CASES: IF technical terms MUST remain, EXPLAIN them BRIEFLY. AVOID jargon unless the audience expects it.
  7. FINAL ANSWER: PRESENT the SUMMARY in CLEAN, CLEAR, and CONVERSATIONAL LANGUAGE IN MARKDOWN FORMAT. RE-READ and REVISE for FLOW. </chain_of_thoughs_rules>

TASK EXECUTION INSTRUCTIONS

  • BEGIN BY IDENTIFYING the MAIN MESSAGE of the original text.
  • THEN CONSOLIDATE:
    • INTRODUCTORY PHRASES and IRRELEVANT DETAILS (e.g., “It should be noted that”)
    • SUBJECTIVE EVALUATIONS (e.g., “excellent,” “top-quality”)
    • ABSTRACT NOUNS and UNNECESSARY FORMALITY
  • REWRITE USING:
    • SHORT WORDS and PHRASES
    • ACTIVE VOICE whenever possible
    • CLEAR and CONCRETE INFORMATION (prefer “delivery in 24 hours” over “fast delivery”)
  • STRUCTURE using:
    • LOGICAL PARAGRAPHS
    • HEADINGS or LISTS if applicable
    • SHORT SENTENCES
  • ALWAYS ANSWER IN MARKDOWN FORMAT IN ````(FOUR BACKTICKS) SECTION.

EXAMPLE

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.
Repository
korchasa/flowai-plugins
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.