From 3b6852bf8687d5fd94bfb75725f37b255e70c76c Mon Sep 17 00:00:00 2001 From: Luong NGUYEN Date: Fri, 30 Jan 2026 14:51:03 +0100 Subject: [PATCH] docs: Add citation requirements to blog-draft skill - Require inline citations for all data points, statistics, and comparisons - Add citation format examples (numbered [1] or named [Source Name]) - Include citation requirements in Tips for Quality section - Ensure factual claims are properly sourced --- 03-skills/blog-draft/SKILL.md | 20 +++++++++++++++++--- 1 file changed, 17 insertions(+), 3 deletions(-) diff --git a/03-skills/blog-draft/SKILL.md b/03-skills/blog-draft/SKILL.md index 56010c7..02adbde 100644 --- a/03-skills/blog-draft/SKILL.md +++ b/03-skills/blog-draft/SKILL.md @@ -153,6 +153,7 @@ Follow these steps sequentially. **Do not skip steps or proceed without user app - Supporting evidence and examples from research - Smooth transitions between sections - Strong conclusion with takeaway + - **Citations**: All comparisons, statistics, data points, and factual claims MUST cite the original source 4. Save the draft as `draft-v0.1.md` in the blog post folder. @@ -162,15 +163,23 @@ Follow these steps sequentially. **Do not skip steps or proceed without user app *[Optional: subtitle or tagline]* - [Full content...] + [Full content with inline citations...] --- ## References - - [Source 1] - - [Source 2] + - [1] Source 1 Title - URL or Citation + - [2] Source 2 Title - URL or Citation + - [3] Source 3 Title - URL or Citation ``` +6. **Citation Requirements**: + - Every data point, statistic, or comparison MUST have an inline citation + - Use numbered references [1], [2], etc., or named citations [Source Name] + - Link citations to the References section at the end + - Example: "Studies show that 65% of developers prefer TypeScript [1]" + - Example: "React outperforms Vue in rendering speed by 20% [React Benchmarks 2024]" + ### Step 7: Commit Draft (if in git repo) 1. Check if in git repository. @@ -244,6 +253,11 @@ blog-posts/ - **Hook**: Start with a question, surprising fact, or relatable scenario - **Flow**: Each paragraph should connect to the next - **Evidence**: Support claims with data from research +- **Citations**: ALWAYS cite sources for: + - All statistics and data points (e.g., "According to [Source], 75% of...") + - Comparisons between products, services, or approaches (e.g., "X performs 2x faster than Y [Source]") + - Factual claims about market trends, research findings, or benchmarks + - Use inline citations with format: [Source Name] or [Author, Year] - **Voice**: Maintain consistent tone throughout - **Length**: Respect the target word count - **Readability**: Use short paragraphs, bullet points where appropriate