# Blog Post Structure Pass > Use this skill when the user asks to restructure, reorganise, improve, rewrite, tighten, or strengthen a blog post, article, newsletter, essay, or thought-leadership draft. - Skill: `kody-w/blog-post-structure-pass` (Agent Skill, multi-file: 3 files) - Install (CLI): `npx skillmds@latest add kody-w/blog-post-structure-pass` - Raw SKILL.md: https://api.skillmd.com/api/skills/kody-w/blog-post-structure-pass/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - Author: kody-w (https://skillmd.com/u/kody-w) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/kody-w/blog-post-structure-pass --- # Blog Post Structure Pass Use this skill to improve the structure, argument, flow, and readability of a blog post while preserving the source facts and the author's intended point of view. ## Core rules - Do not invent evidence, examples, client stories, dates, results, or quotes. - Preserve the author's stance unless asked to change it. - Improve the shape of the argument before polishing sentences. - Keep the revised post suitable for the intended audience and channel. - If important evidence is missing, mark it as a gap rather than filling it in. ## Default post skeleton Use this skeleton as a guide, not a rigid template: 1. **Hook / tension** - Why this matters now. 2. **Problem** - What people usually misunderstand or struggle with. 3. **Reframe** - The more useful way to think about it. 4. **Practical implications** - What changes in decisions, behaviour, governance, delivery, or operations. 5. **Example or proof** - Evidence from supplied material. 6. **Takeaway** - What the reader should do, question, or remember. ## Workflow 1. Read the source post or draft. 2. Identify the current thesis and intended audience. 3. Diagnose structural issues: weak opening, unclear argument, repetition, missing transitions, unsupported claims, premature solutioning, or weak ending. 4. Create a revised outline. 5. Rewrite the post into the improved structure. 6. Preserve factual claims from the source and avoid adding unsupported material. 7. Provide a short change note only if useful. ## Output format ```markdown # [Revised title] [Rewritten post] --- ## Change notes - [Only include important changes, assumptions, or evidence gaps.] ``` If the user asks for the structure only, use: ```markdown ## Recommended structure 1. [Section] 2. [Section] 3. [Section] ## Rationale [Short explanation] ``` ## References This skill includes supporting reference material. Read the relevant reference file when the task needs additional structure, rubric detail, examples, or checklist support. - `references/post-structure-patterns.md` - use this when additional structure, examples, or checks are useful for the task. ## Quality checklist Before responding, check: - The revised post has a clear thesis. - The opening creates relevance quickly. - The middle develops the argument rather than listing points. - The ending lands the insight or next action. - No unsupported facts have been added. - The copy sounds natural and human. ## Run this — do not improvise This capability's deterministic implementation is a RAPP single-file agent, linked beside this file as `blog_post_structure_pass_agent.py` and embedded as the fenced Python below (sha256 d945fe9a0407a5e1…; a byte-exact copy is also vaulted in the capsule comment at the end of this file). On a host with sandbox execution, run the linked file directly — if it is missing, write the fence contents verbatim to `blog_post_structure_pass_agent.py` first: ```bash python3 blog_post_structure_pass_agent.py '{"key": "value"}' # arguments as one JSON object echo '{"key": "value"}' | python3 blog_post_structure_pass_agent.py # or on stdin python3 blog_post_structure_pass_agent.py --tool # emit the JSON tool contract ``` Treat stdout as a tool result. If it reports missing or unresolved inputs, stop and collect them. If it returns `steps`, execute those steps in order exactly as returned; if it returns `instructions`, follow them with the supplied inputs. Otherwise use the result verbatim. Do not invent behavior beyond that output. On a host without code execution, treat the Parameters schema and the code below as the exact specification and never paraphrase a step. Never edit inside the generated markers; a converter-equipped host can instead restore the original file checksum-verified with the installed `rapp-agent-converter/scripts/toast.py convert SKILL.md --to agent`. ````python # rapp:deterministic """BlogPostStructurePass -- Use this skill when the user asks to restructure, reorganise, improve, rewrite, tighten, or strengthen a blog post, article, newsletter, essay, or thought-leadership draft. Generated by the rapp skill from blog-post-structure-pass. The RCI capsule at the bottom of this file carries the full original; `toast.py convert` restores it byte-exact.""" import json import re import sys try: from agents.basic_agent import BasicAgent except ImportError: # running OUTSIDE a brainstem -- stay executable anyway. class BasicAgent: # noqa: D101 - minimal stand-in, same contract def __init__(self, name=None, metadata=None): if name: self.name = name if metadata: self.metadata = metadata def perform(self, **kwargs): return "Not implemented." def system_context(self): return None def to_tool(self): return {"type": "function", "function": { "name": self.name, "description": self.metadata.get("description", ""), "parameters": self.metadata.get("parameters", {})}} # The procedural layer, verbatim from the source capability. INSTRUCTIONS = "# Blog Post Structure Pass\n\nUse this skill to improve the structure, argument, flow, and readability of a blog post while preserving the source facts and the author's intended point of view.\n\n## Core rules\n\n- Do not invent evidence, examples, client stories, dates, results, or quotes.\n- Preserve the author's stance unless asked to change it.\n- Improve the shape of the argument before polishing sentences.\n- Keep the revised post suitable for the intended audience and channel.\n- If important evidence is missing, mark it as a gap rather than filling it in.\n\n## Default post skeleton\n\nUse this skeleton as a guide, not a rigid template:\n\n1. **Hook / tension** - Why this matters now.\n2. **Problem** - What people usually misunderstand or struggle with.\n3. **Reframe** - The more useful way to think about it.\n4. **Practical implications** - What changes in decisions, behaviour, governance, delivery, or operations.\n5. **Example or proof** - Evidence from supplied material.\n6. **Takeaway** - What the reader should do, question, or remember.\n\n## Workflow\n\n1. Read the source post or draft.\n2. Identify the current thesis and intended audience.\n3. Diagnose structural issues: weak opening, unclear argument, repetition, missing transitions, unsupported claims, premature solutioning, or weak ending.\n4. Create a revised outline.\n5. Rewrite the post into the improved structure.\n6. Preserve factual claims from the source and avoid adding unsupported material.\n7. Provide a short change note only if useful.\n\n## Output format\n\n```markdown\n# [Revised title]\n\n[Rewritten post]\n\n---\n\n## Change notes\n\n- [Only include important changes, assumptions, or evidence gaps.]\n```\n\nIf the user asks for the structure only, use:\n\n```markdown\n## Recommended structure\n\n1. [Section]\n2. [Section]\n3. [Section]\n\n## Rationale\n\n[Short explanation]\n```\n\n\n## References\n\nThis skill includes supporting reference material. Read the relevant reference file when the task needs additional structure, rubric detail, examples, or checklist support.\n\n- `references/post-structure-patterns.md` - use this when additional structure, examples, or checks are useful for the task.\n\n## Quality checklist\n\nBefore responding, check:\n\n- The revised post has a clear thesis.\n- The opening creates relevance quickly.\n- The middle develops the argument rather than listing points.\n- The ending lands the insight or next action.\n- No unsupported facts have been added.\n- The copy sounds natural and human." # Ordered commands lifted verbatim from the capability's own documentation. STEPS = [] class BlogPostStructurePassAgent(BasicAgent): def __init__(self): self.name = 'BlogPostStructurePass' self.metadata = { "name": "BlogPostStructurePass", "description": "Use this skill when the user asks to restructure, reorganise, improve, rewrite, tighten, or strengthen a blog post, article, newsletter, essay, or thought-leadership draft.", "parameters": { "type": "object", "properties": {}, "required": [] } } super().__init__(name=self.name, metadata=self.metadata) def perform(self, **kwargs): # toaster:generated-perform return json.dumps({"status": "ok", "instructions": INSTRUCTIONS, "inputs": kwargs, "note": "Prose-only capability: follow INSTRUCTIONS " "with the given inputs."}, indent=2) if __name__ == "__main__": # echo '{"arg": "value"}' | python3 blog_post_structure_pass_agent.py # python3 blog_post_structure_pass_agent.py '{"arg": "value"}' # python3 blog_post_structure_pass_agent.py --tool # emit the JSON tool contract _a = sys.argv[1:] if _a and _a[0] == "--tool": print(json.dumps(BlogPostStructurePassAgent().to_tool(), indent=2)) else: _raw = _a[0] if _a else (sys.stdin.read().strip() or "{}") print(BlogPostStructurePassAgent().perform(**json.loads(_raw))) # rci-capsule:v1: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 ````