Files
our-claude-skills/official-skils-collection/notion-research-documentation/reference/format-selection-guide.md
Andrew Yim 341d5f5a5b Initial commit: Claude Skills Factory with 8 refined custom skills
Custom Skills (ourdigital-custom-skills/):
- 00-ourdigital-visual-storytelling: Blog featured image prompt generator
- 01-ourdigital-research-publisher: Research-to-publication workflow
- 02-notion-organizer: Notion workspace management
- 03-research-to-presentation: Notion research to PPT/Figma
- 04-seo-gateway-strategist: SEO gateway page strategy planning
- 05-gateway-page-content-builder: Gateway page content generation
- 20-jamie-brand-editor: Jamie Clinic branded content GENERATION
- 21-jamie-brand-guardian: Jamie Clinic content REVIEW & evaluation

Refinements applied:
- All skills converted to SKILL.md format with YAML frontmatter
- Added version fields to all skills
- Flattened nested folder structures
- Removed packaging artifacts (.zip, .skill files)
- Reorganized file structures (scripts/, references/, etc.)
- Differentiated Jamie skills with clear roles

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-10 17:56:04 +09:00

2.7 KiB

Format Selection Guide

Choose the right output format for your research needs.

Decision Tree

Is this comparing multiple options?
  ├─ YES → Use Comparison Format
  └─ NO ↓

Is this time-sensitive or simple?
  ├─ YES → Use Quick Brief
  └─ NO ↓

Does this require formal/extensive documentation?
  ├─ YES → Use Comprehensive Report
  └─ NO → Use Research Summary (default)

Format Overview

Format Length When to Use Template
Research Summary 500-1000 words Most research requests (default) Template
Comprehensive Report 1500+ words Formal docs, strategic decisions Template
Quick Brief 200-400 words Time-sensitive, simple topics Template
Comparison 800-1200 words Evaluating options Template

Formatting Guidelines

Headings

  • Use # for title
  • Use ## for major sections
  • Use ### for subsections
  • Keep heading hierarchy consistent

Lists

  • Use - for bullet points
  • Use 1. for numbered lists
  • Keep list items parallel in structure

Emphasis

  • Use **bold** for key terms and section labels
  • Use *italic* for emphasis
  • Use sparingly for maximum impact

Citations

  • Always use <mention-page url="...">Page Title</mention-page> for source pages
  • Include citation immediately after referenced information
  • Group all sources in a "Sources" section at the end

Tables

  • Use for structured data comparison
  • Keep columns to 3-5 for readability
  • Include header row
  • Align content appropriately

Code Blocks

Use when including:

  • Technical specifications
  • Configuration examples
  • Command examples
Example code or configuration here

Content Guidelines

Executive Summaries

  • Lead with the most important finding
  • Include 1-2 key implications
  • Make it standalone (reader gets value without reading further)
  • Target 2-3 sentences for summaries, 1 paragraph for reports

Key Findings

  • Start with a clear headline
  • Support with specific evidence
  • Include relevant data points or quotes
  • Cite source immediately
  • Focus on actionable insights

Recommendations

  • Make them specific and actionable
  • Explain the "why" behind each recommendation
  • Prioritize clearly (Priority 1, 2, 3 or High/Medium/Low)
  • Include implementation hints when relevant

Source Citations

  • Link to original pages using mentions
  • Note if information is outdated (check last-edited dates)
  • Credit specific sections when quoting
  • Group related sources together