Update: About pages with skills-based LLM description

dshkol · claude · dshkol · commit 2a101386c656 · 2026-01-07T12:09:18.000-08:00
- Concise description of the system architecture - Links to blog post and GitHub repo - Bilingual (EN/FR) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
diff --git a/docs/en/about/index.md b/docs/en/about/index.md
@@ -5,83 +5,24 @@ toc: false
 
 # About The D-AI-LY
 
-The D-AI-LY is an experimental project that generates statistical news bulletins using artificial intelligence. It draws inspiration from Statistics Canada's official publication, [The Daily](https://www.statcan.gc.ca/en/dai/dai), which has been Canada's first release of new statistical data since 1932.
+The D-AI-LY generates statistical bulletins from Statistics Canada's CANSIM database using a Skills-based LLM harness. It was built with Claude Code but should work with any agentic CLI tool that can invoke SKILL.MD files. It is not affiliated with Statistics Canada in any way.
 
-## What We Do
+## Process
 
-Every day, The D-AI-LY:
+1. Fetch metadata from CANSIM/NDM tables via the [cansim R package](https://mountainmath.github.io/cansim/) to autonomously identify new and interesting data and retreive structured data objects. 
+2. Generate bilingual articles (EN/FR) using an LLM model following specific guidance on narrative, voice, tone, and visual style. 
+3. Publish and build a static site using the Observable.js framework.
 
-1. **Scans** Statistics Canada's CANSIM database for recently updated tables
-2. **Selects** newsworthy topics based on recency, public interest, and sector diversity
-3. **Fetches** the latest data using the official Statistics Canada API
-4. **Generates** bilingual articles (English and French) explaining the key findings
-5. **Publishes** the articles to this website
+Each article cites its source table, documents R code for reproducibility, and links to official Statistics Canada data.
 
-All data comes directly from Statistics Canada. The articles are generated by AI and reviewed for accuracy.
+## Limitations
 
-## How It Works
+LLM-generated content goes through automated reviews but may very well still contain errors. Do not use for any official purposes and verify statistics by consulting the [official Statistics Canada source](https://www.statcan.gc.ca/)
 
-```
-┌─────────────────────────────────────────┐
-│         Daily Automation (8am)          │
-└─────────────────┬───────────────────────┘
-                  │
-    ┌─────────────▼─────────────┐
-    │   Topic Discovery (AI)    │  What's newsworthy today?
-    └─────────────┬─────────────┘
-                  │
-    ┌─────────────▼─────────────┐
-    │   Data Fetch (R/cansim)   │  Get real StatCan data
-    └─────────────┬─────────────┘
-                  │
-    ┌─────────────▼─────────────┐
-    │  Article Generation (AI)  │  Write EN + FR articles
-    └─────────────┬─────────────┘
-                  │
-    ┌─────────────▼─────────────┐
-    │   Publish to Website      │  Build and deploy
-    └───────────────────────────┘
-```
+## More Information
 
-## Data Sources
-
-All statistical data is sourced from **Statistics Canada's CANSIM database** (now called the New Dissemination Model). We use the [cansim R package](https://mountainmath.github.io/cansim/) to access official data tables.
-
-Each article includes:
-- The specific CANSIM table number
-- A direct link to the source data
-- The reference period for the statistics
-
-## AI Transparency
-
-This project uses AI (Claude by Anthropic) for two purposes:
-
-1. **Topic Selection**: Identifying which statistical releases are most newsworthy
-2. **Article Writing**: Generating the text of each article based on the data
-
-The AI follows strict guidelines to maintain the neutral, clinical voice of statistical reporting. It does not editorialize or make predictions—it simply reports the numbers.
-
-**Important**: While we strive for accuracy, AI-generated content may contain errors. Always verify important statistics by consulting the [official Statistics Canada source](https://www.statcan.gc.ca/).
-
-## The Daily Voice
-
-Articles follow the style of Statistics Canada's The Daily:
-
-- **Neutral and clinical** — no emotional language
-- **Inverted pyramid** — most important facts first
-- **Plain language** — accessible to general audiences
-- Headlines lead with the key number
-- Always compare to previous period AND year-over-year
-
-## Open Source
-
-The D-AI-LY is an open source project. You can view the code, report issues, or contribute on GitHub:
-
-**[github.com/mountainmath/the-daily](https://github.com/mountainmath/the-daily)**
-
-## Disclaimer
-
-The D-AI-LY is not affiliated with Statistics Canada. This is an independent experimental project that uses publicly available data. For official statistics, please visit [statcan.gc.ca](https://www.statcan.gc.ca/).
+- [How The D-AI-LY Works](https://www.dshkol.com/post/the-daily/) — This is a blog post that goes into much more detail on how this system works, what each skill does, and how the skills were assembled. 
+- [GitHub Repository](https://github.com/dshkol/thedaily) — I've published this project as an open-source repo. All content including custom SKILL.MD files is available in the repo here. 
 
 ---
 
diff --git a/docs/fr/about/index.md b/docs/fr/about/index.md
@@ -5,83 +5,24 @@ toc: false
 
 # À propos du D-AI-LY
 
-Le D-AI-LY est un projet expérimental qui génère des bulletins statistiques à l'aide de l'intelligence artificielle. Il s'inspire de la publication officielle de Statistique Canada, [Le Quotidien](https://www.statcan.gc.ca/fr/quo/quo), qui constitue la première source de diffusion de nouvelles données statistiques au Canada depuis 1932.
+Le D-AI-LY génère des bulletins statistiques à partir de la base de données CANSIM de Statistique Canada en utilisant un système LLM basé sur des Skills. Il a été construit avec Claude Code mais devrait fonctionner avec tout outil CLI agentique capable d'invoquer des fichiers SKILL.MD. Il n'est aucunement affilié à Statistique Canada.
 
-## Ce que nous faisons
+## Processus
 
-Chaque jour, Le D-AI-LY :
+1. Récupérer les métadonnées des tableaux CANSIM/NDM via le [progiciel R cansim](https://mountainmath.github.io/cansim/) pour identifier de manière autonome des données nouvelles et intéressantes et récupérer des objets de données structurées.
+2. Générer des articles bilingues (FR/EN) à l'aide d'un modèle LLM suivant des directives spécifiques sur le narratif, la voix, le ton et le style visuel.
+3. Publier et compiler un site statique en utilisant le cadre Observable.js.
 
-1. **Analyse** la base de données CANSIM de Statistique Canada pour repérer les tableaux récemment mis à jour
-2. **Sélectionne** les sujets dignes d'intérêt selon leur actualité, l'intérêt public et la diversité sectorielle
-3. **Récupère** les données les plus récentes à l'aide de l'API officielle de Statistique Canada
-4. **Génère** des articles bilingues (français et anglais) expliquant les principales conclusions
-5. **Publie** les articles sur ce site Web
+Chaque article cite son tableau source, documente le code R pour la reproductibilité et renvoie aux données officielles de Statistique Canada.
 
-Toutes les données proviennent directement de Statistique Canada. Les articles sont générés par l'IA et vérifiés pour leur exactitude.
+## Limitations
 
-## Fonctionnement
+Le contenu généré par LLM passe par des revues automatisées mais peut très bien contenir des erreurs. Ne pas utiliser à des fins officielles et vérifier les statistiques en consultant la [source officielle de Statistique Canada](https://www.statcan.gc.ca/).
 
-```
-┌─────────────────────────────────────────┐
-│      Automatisation quotidienne (8 h)   │
-└─────────────────┬───────────────────────┘
-                  │
-    ┌─────────────▼─────────────┐
-    │  Découverte de sujets (IA)│  Quoi de neuf aujourd'hui?
-    └─────────────┬─────────────┘
-                  │
-    ┌─────────────▼─────────────┐
-    │  Récupération (R/cansim)  │  Obtenir les données StatCan
-    └─────────────┬─────────────┘
-                  │
-    ┌─────────────▼─────────────┐
-    │  Génération d'articles (IA)│  Rédiger en FR + EN
-    └─────────────┬─────────────┘
-                  │
-    ┌─────────────▼─────────────┐
-    │   Publication sur le site │  Compiler et déployer
-    └───────────────────────────┘
-```
+## Plus d'information
 
-## Sources des données
-
-Toutes les données statistiques proviennent de la **base de données CANSIM de Statistique Canada** (maintenant appelée le Nouveau modèle de diffusion). Nous utilisons le [progiciel R cansim](https://mountainmath.github.io/cansim/) pour accéder aux tableaux officiels.
-
-Chaque article comprend :
-- Le numéro du tableau CANSIM
-- Un lien direct vers les données sources
-- La période de référence des statistiques
-
-## Transparence sur l'IA
-
-Ce projet utilise l'IA (Claude d'Anthropic) à deux fins :
-
-1. **Sélection des sujets** : Identifier les diffusions statistiques les plus dignes d'intérêt
-2. **Rédaction des articles** : Générer le texte de chaque article à partir des données
-
-L'IA suit des directives strictes pour maintenir le ton neutre et clinique du reportage statistique. Elle n'éditorialise pas et ne fait pas de prédictions — elle rapporte simplement les chiffres.
-
-**Important** : Bien que nous visions l'exactitude, le contenu généré par l'IA peut contenir des erreurs. Veuillez toujours vérifier les statistiques importantes en consultant la [source officielle de Statistique Canada](https://www.statcan.gc.ca/).
-
-## Le style du Quotidien
-
-Les articles suivent le style du Quotidien de Statistique Canada :
-
-- **Neutre et clinique** — pas de langage émotionnel
-- **Pyramide inversée** — les faits les plus importants en premier
-- **Langage simple** — accessible au grand public
-- Les titres mettent en avant le chiffre clé
-- Toujours comparer à la période précédente ET à l'année précédente
-
-## Code source ouvert
-
-Le D-AI-LY est un projet à code source ouvert. Vous pouvez consulter le code, signaler des problèmes ou contribuer sur GitHub :
-
-**[github.com/mountainmath/the-daily](https://github.com/mountainmath/the-daily)**
-
-## Avertissement
-
-Le D-AI-LY n'est pas affilié à Statistique Canada. Il s'agit d'un projet expérimental indépendant qui utilise des données accessibles au public. Pour les statistiques officielles, veuillez consulter [statcan.gc.ca](https://www.statcan.gc.ca/).
+- [Comment fonctionne Le D-AI-LY](https://www.dshkol.com/post/the-daily/) — Article de blogue qui explique en détail le fonctionnement de ce système, ce que fait chaque skill et comment les skills ont été assemblés.
+- [Dépôt GitHub](https://github.com/dshkol/thedaily) — Ce projet est publié en tant que dépôt open-source. Tout le contenu, y compris les fichiers SKILL.MD personnalisés, est disponible dans le dépôt.
 
 ---
 
