{
  "@type": "help_guide",
  "id": "content-production",
  "title": "Writing a piece",
  "kind": "feature",
  "summary": "\"Write the blog\" runs the whole pipeline: competitor research, link research, the brief, the draft, quality checks with up to two revisions, and images. It posts progress in the thread and a link to the piece's page when it's done.",
  "aliases": [
    "write a blog",
    "produce a piece",
    "content production",
    "write the article",
    "draft the blog",
    "review a draft",
    "edit a draft"
  ],
  "engine": null,
  "agents": [],
  "related": [
    {
      "id": "content-calendar",
      "page": "https://nexus.effiqs.com/help/content-calendar"
    },
    {
      "id": "publishing",
      "page": "https://nexus.effiqs.com/help/publishing"
    },
    {
      "id": "how-to-ask-nexus",
      "page": "https://nexus.effiqs.com/help/how-to-ask-nexus"
    },
    {
      "id": "knowledge-base",
      "page": "https://nexus.effiqs.com/help/knowledge-base"
    }
  ],
  "reviewed": "2026-10-14",
  "sections": [
    {
      "heading": "What it does",
      "key": "what-it-does",
      "markdown": "\"Write the blog\" runs the whole pipeline: competitor research, link research, the brief, the draft, quality checks with up to two revisions, and images. It posts progress in the thread and a link to the piece's page when it's done."
    },
    {
      "heading": "Use it",
      "key": "use-it",
      "markdown": "1. **\"Write the blog [title].\"** Use the exact calendar title, or its date.\n2. Open the piece's page from the link or the calendar. Every field (title, slug, meta, excerpt, body) is editable there.\n3. Change one thing instead of redoing it:\n   - **\"Rewrite the meta description of [title] to lead with cost savings.\"**\n   - **\"Revise [title]: add a manufacturing example to section 2.\"**\n   - **\"Regenerate the hero image of [title]: brighter, no text.\"**\n4. Need a Google Doc for the client? **\"Export [title] to a Google Doc.\"**"
    },
    {
      "heading": "Before you publish",
      "key": "before-you-publish",
      "markdown": "Before publishing, check:\n\n- the facts and figures (anything not on file should be marked for a source);\n- the internal and external links open the right pages;\n- the images;\n- the CTA at the end."
    },
    {
      "heading": "Troubleshooting",
      "key": "troubleshooting",
      "markdown": "- **QA keeps failing on the same check.** Some checks can't be fixed by rewriting (too few pages to link to, no author set). Nexus says what to fix outside the draft.\n- **The piece reads generic.** Add documents to the knowledge base or answer Nexus's open questions about the client."
    },
    {
      "heading": "Prompts",
      "key": "prompts",
      "markdown": "- \"Write the blog [title].\"\n- \"Rewrite the meta description of [title] to lead with cost savings.\"\n- \"Revise [title]: add a manufacturing example to section 2.\"\n- \"Regenerate the hero image of [title]: brighter, no text.\"\n- \"Export [title] to a Google Doc.\""
    }
  ],
  "prompts": [
    {
      "text": "Write the blog [title].",
      "tool": "produce_content_piece"
    },
    {
      "text": "Rewrite the meta description of [title] to lead with cost savings.",
      "tool": "rewrite_content_field"
    },
    {
      "text": "Revise [title]: add a manufacturing example to section 2.",
      "tool": "revise_content_draft"
    },
    {
      "text": "Regenerate the hero image of [title]: brighter, no text.",
      "tool": "generate_content_images"
    },
    {
      "text": "Export [title] to a Google Doc.",
      "tool": "export_content_record_to_doc"
    }
  ],
  "page": "https://nexus.effiqs.com/help/content-production",
  "markdown": "https://nexus.effiqs.com/help/content-production.md"
}