Generating Content Skill

This skill provides guidance for creating new wiki pages and content.

Creating New Pages

1. Choose the Right Page Type

Set via frontmatter:

---
title: "Page Title"
pageType: stub  # omit for content pages
---

2. Follow Template Requirements

Different sections require different structures. See .claude/docs/content-quality.md for full details.

Model Pages require:

• •Overview (2-3 paragraphs)
• •Conceptual Framework (diagram + explanation)
• •Quantitative Analysis (tables with uncertainty ranges)
• •Strategic Importance
• •Limitations

Risk Pages require:

• •Overview
• •Risk Assessment table (severity, likelihood, timeline)
• •Responses That Address This Risk
• •Why This Matters
• •Key Uncertainties

Response Pages require:

• •Overview
• •Quick Assessment table
• •Risks Addressed
• •How It Works
• •Critical Assessment

3. Frontmatter Template

---
title: "Page Title"
description: "1-2 sentence summary with key conclusion"
quality: 3
lastEdited: "2025-01-30"
ratings:
  novelty: 4
  rigor: 3
  actionability: 4
  completeness: 3
todos:
  - "Complete 'How It Works' section"
  - "Add Key Uncertainties"
---

Critical: The description field must include both methodology AND conclusions. It's shown in previews.

Good: "This model estimates AI's marginal contribution to bioweapons risk. It finds current LLMs provide 1.3-2.5x uplift for non-experts."

Bad: "Analysis of AI bioweapons risk" (no conclusion)

Adding Cross-References

Internal Links

Use <EntityLink> for wiki cross-references:

import {EntityLink} from '../../../../components/wiki';

<EntityLink id="scheming" />  <!-- Auto-fetches title -->
<EntityLink id="scheming">deceptive behavior</EntityLink>  <!-- Custom label -->

External Sources

Check if URL exists in resource database first:

npm run crux -- resources show [page-name]

If exists, use <R> component:

import {R} from '../../../../components/wiki';
<R id="hash">Source label</R>

If not, use markdown link (will be tracked for later conversion).

AI Transition Model Pages

For ATM pages, YAML is the single source of truth:

MDX files should be minimal:

---
title: "Compute (AI Capabilities)"
sidebar:
  order: 1
---
import {TransitionModelContent} from '../../../../../components/wiki';

## Overview

[Custom prose content here]

---

<TransitionModelContent slug="compute" client:load />

Using Diagrams

Mermaid (for flowcharts, sequences)

<Mermaid client:load chart={`
flowchart TD
    A[Start] --> B[Process]
    B --> C[End]
`} />

See .claude/docs/mermaid-diagrams.md for syntax guidelines.

Cause-Effect Graphs (for causal models)

For ATM entity pages, use cause-effect graphs defined in YAML. See .claude/docs/cause-effect-graphs.md.

Validation

Before completing new pages:

npm run crux -- validate compile --quick   # Verify MDX compiles
npm run crux -- validate refs              # Check EntityLink/DataInfoBox references
npm run validate                           # Full validation suite

Common MDX Escaping Issues

These cause CI failures:

After Creating Content

Rebuild the data layer if you added new entities:

npm run build:data

Cross-Linking Checklist (Important!)

After creating a new page, always check cross-linking:

# 1. Check what links TO and FROM this entity
npm run crux -- analyze entity-links <entity-id>

# 2. Add EntityLinks to pages that mention this entity
# (The analyzer shows which pages mention but don't link)

# 3. Add EntityLinks FROM this page to related entities
# (Look for entity names in your content that could be linked)

Priority Cross-Links (most important to include):

• •Creators/Authors: If the subject was created by someone in the wiki, ALWAYS EntityLink them
  • •Tool pages should link to their creator
  • •Research projects should link to lead researchers
• •Related Projects: Link to sibling projects by the same creator
• •Funders/Organizations: Link to funding sources and affiliated orgs
• •Key People: Link to researchers and notable figures mentioned substantively

Why this matters:

• •New pages aren't automatically linked from existing content
• •Poor cross-linking reduces discoverability
• •Related pages (like a person and their organization) should link to each other
• •The page-creator now validates cross-links and warns if none are found

Quick fix for bulk issues:

npm run crux -- fix entity-links

Run link analysis to check integration:

npm run crux -- analyze links