# Essay Writing

> Writing support (drafting, evaluation and revision) for executives and tech leaders. Support everything from internal culture-building to external technical branding.

- Skill: `diegosouzapw/essay-writing` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add diegosouzapw/essay-writing`
- Raw SKILL.md: https://api.skillmd.com/api/skills/diegosouzapw/essay-writing/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: diegosouzapw (https://skillmd.com/u/diegosouzapw)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/diegosouzapw/essay-writing

---


# Essay Writing Skill

Provide high-impact essay writing support for technology leaders (CTOs, VPoEs, Engineering Managers, etc.).

## Target Platforms & Tones

Adapt the writing style based on the intended audience and platforms.

| Publication Type          | Primary Audience                     | Recommended Tone                             |
|:--------------------------|:-------------------------------------|:---------------------------------------------|
| **Internal (Notes/Wiki)** | Employees, Engineers, Managers       | Casual, personal, transparent, authentic     |
| **External (Tech Blog)**  | Industry peers, potential candidates | Polished, passionate, logical, authoritative |

---

## Workflow

Identify the current phase of the request and reference the appropriate guidelines in the `references/` directory.

### Phase 1: Outlining & Structure
* **Reference:** Analyze `references/writing-style.md` to apply the correct structure pattern (Pattern A for Internal, Pattern B for External).
* **Key Principle:** Propose **"Assertive Headings"**—headings should be statements or takeaways that convey the author's message, not generic labels.

### Phase 2: Drafting
* **Reference:** Apply the tone and constraints found in `references/writing-style.md` and `references/rules.md`.
* **Key Principle:** Avoid generic "AI-speak." Write in an **authentic voice** that reflects the author's unique perspective and experience.

### Phase 3: Review & Revision
Select the specific mode based on the user's prompt:

| Keyword                        | Mode              | Description                                                                                              |
| :----------------------------- | :---------------- | :------------------------------------------------------------------------------------------------------- |
| **"Evaluate" / 「評価して」**    | **Scoring**       | Rate the draft on 5 dimensions (0.0–5.0). Output a diagnostic report **without** auto-fixing the text.   |
| **"Revise" / 「推敲して」 **     | **Self-Revision** | A full cycle: Evaluate → Line-level fixes → Structural reorganization → Polishing → Final Re-evaluation. |
| **"Review" / 「レビューして」 ** | **Peer Feedback** | Act as a peer reviewer. Provide feedback using the **Good / Question / Suggestion** format.              |

## Usage Examples

### 1. Outlining
* **EN:** "Give me an outline for an internal note regarding 'Our Philosophy on Engineering Career Paths'."
* **JP:** 「エンジニアのキャリア形成の考え方」について、社内向けの構成案を出して
* **Action:** Apply `references/writing-style.md` (Pattern A)

### 2. Drafting
* **EN:** "Write a draft based on this outline. Keep the tone passionate and lead-by-example."
* **JP:** この構成案をもとに下書きを書いて。情熱的で、背中で語るようなトーンで。
* **Action:** Reference `references/writing-style.md` + `references/rules.md`

### 3. Evaluation or Revision
* **EN:** "Evaluate this draft's impact and then revise it for a public tech blog."
* **JP:** この下書きを評価して。その後、テックブログ掲載用に推敲して。
* **Action:** Execute `references/review.md` Part 1 (Score) → Part 2 & 3 (Revision)

### 4. Peer Review / レビュー
* **EN:** "Review this draft from a hiring candidate's perspective."
* **JP:** 採用候補者の視点で、この下書きをレビューして。
* **Action:** Execute `references/review.md` Part 4