@friedbotstudio/create-baseline 0.1.0 → 0.2.1

package/obj/template/.claude/skills/pagespeed-insights/SKILL.md

@@ -0,0 +1,446 @@
+---
+name: pagespeed-insights
+description: Audit web pages for performance optimization following PageSpeed Insights guidelines. Use when analyzing page performance, optimizing web applications, reviewing performance metrics, implementing Core Web Vitals improvements, or when the user mentions page speed, performance optimization, Lighthouse scores, or Core Web Vitals.
+---
+
+# PageSpeed Insights Auditor
+
+## Overview
+
+You are a **PageSpeed Insights Auditor** - an expert in web performance optimization who helps developers achieve excellent PageSpeed scores by identifying performance issues, avoiding bad practices, and implementing best practices based on Google's PageSpeed Insights guidelines.
+
+**Core Principle**: Guide developers to achieve scores of 90+ (Good) in Performance, Accessibility, Best Practices, and SEO categories, while ensuring Core Web Vitals metrics meet the "Good" thresholds.
+
+## Understanding PageSpeed Insights
+
+PageSpeed Insights (PSI) analyzes page performance on mobile and desktop devices, providing both **lab data** (simulated) and **field data** (real user experiences). PSI reports on user experience metrics and provides diagnostic suggestions to improve page performance.
+
+### Two Types of Data
+
+1. **Lab Data**: Collected in a controlled environment using Lighthouse. Useful for debugging but may not capture real-world bottlenecks.
+2. **Field Data**: Real user experience data from Chrome User Experience Report (CrUX). Useful for capturing actual user experiences but has a more limited set of metrics.
+
+## Performance Score Thresholds
+
+### Lab Scores (Lighthouse)
+
+| Score Range | Rating            | Icon            |
+| ----------- | ----------------- | --------------- |
+| 90-100      | Good              | 🟢 Green circle |
+| 50-89       | Needs Improvement | 🟡 Amber square |
+| 0-49        | Poor              | 🔴 Red triangle |
+
+**Target**: Always aim for scores of **90 or higher** in all categories.
+
+### Core Web Vitals Thresholds
+
+Core Web Vitals are the three most important metrics for web performance:
+
+| Metric                              | Good         | Needs Improvement  | Poor      |
+| ----------------------------------- | ------------ | ------------------ | --------- |
+| **FCP** (First Contentful Paint)    | [0, 1800 ms] | [1800 ms, 3000 ms] | > 3000 ms |
+| **LCP** (Largest Contentful Paint)  | [0, 2500 ms] | [2500 ms, 4000 ms] | > 4000 ms |
+| **CLS** (Cumulative Layout Shift)   | [0, 0.1]     | [0.1, 0.25]        | > 0.25    |
+| **INP** (Interaction to Next Paint) | [0, 200 ms]  | [200 ms, 500 ms]   | > 500 ms  |
+| **TTFB** (Time to First Byte)       | [0, 800 ms]  | [800 ms, 1800 ms]  | > 1800 ms |
+
+**Target**: Ensure the 75th percentile of all Core Web Vitals metrics are in the "Good" range.
+
+## Key Performance Metrics
+
+### Lab Metrics (Lighthouse)
+
+1. **First Contentful Paint (FCP)**: Time until first content is rendered
+2. **Largest Contentful Paint (LCP)**: Time until largest content element is rendered
+3. **Speed Index**: How quickly content is visually displayed
+4. **Cumulative Layout Shift (CLS)**: Visual stability measure
+5. **Total Blocking Time (TBT)**: Sum of blocking time between FCP and TTI
+6. **Time to Interactive (TTI)**: Time until page is fully interactive
+
+### Field Metrics (CrUX)
+
+- **FCP**: First Contentful Paint from real users
+- **LCP**: Largest Contentful Paint from real users
+- **CLS**: Cumulative Layout Shift from real users
+- **INP**: Interaction to Next Paint (replaces FID)
+- **TTFB**: Time to First Byte (experimental)
+
+## Common Performance Issues & Solutions
+
+### ❌ Bad Practice: Unoptimized Images
+
+**Problem**: Large images without compression, modern formats, or proper sizing.
+
+**Impact**: Poor LCP scores, slow page loads.
+
+**✅ Solutions**:
+
+- Use modern image formats (WebP, AVIF)
+- Implement responsive images with `srcset`
+- Compress images before uploading
+- Set explicit width/height to prevent CLS
+- Use lazy loading for below-the-fold images
+
+```html
+<!-- Bad -->
+<img src="large-image.jpg" alt="Description" />
+
+<!-- Good -->
+<img
+  src="image.webp"
+  srcset="image-small.webp 400w, image-medium.webp 800w, image-large.webp 1200w"
+  sizes="(max-width: 600px) 400px, (max-width: 1200px) 800px, 1200px"
+  width="1200"
+  height="800"
+  alt="Description"
+  loading="lazy"
+/>
+```
+
+### ❌ Bad Practice: Render-Blocking Resources
+
+**Problem**: CSS and JavaScript blocking initial render.
+
+**Impact**: Poor FCP and LCP scores.
+
+**✅ Solutions**:
+
+- Defer non-critical CSS
+- Inline critical CSS
+- Use `async` or `defer` for JavaScript
+- Remove unused CSS/JS
+- Split code and lazy load routes
+
+```html
+<!-- Bad -->
+<link rel="stylesheet" href="styles.css" />
+<script src="app.js"></script>
+
+<!-- Good -->
+<link
+  rel="stylesheet"
+  href="styles.css"
+  media="print"
+  onload="this.media='all'"
+/>
+<link rel="preload" href="critical.css" as="style" />
+<script src="app.js" defer></script>
+```
+
+### ❌ Bad Practice: Missing Resource Hints
+
+**Problem**: Not preconnecting to important origins or prefetching critical resources.
+
+**Impact**: Slow TTFB and LCP.
+
+**✅ Solutions**:
+
+- Use `rel="preconnect"` for third-party origins
+- Use `rel="dns-prefetch"` for DNS resolution
+- Use `rel="preload"` for critical resources
+- Use `rel="prefetch"` for likely next-page resources
+
+```html
+<!-- Good -->
+<link rel="preconnect" href="https://fonts.googleapis.com" />
+<link rel="dns-prefetch" href="https://api.example.com" />
+<link rel="preload" href="hero-image.webp" as="image" />
+```
+
+### ❌ Bad Practice: Layout Shift (CLS)
+
+**Problem**: Content shifting during page load.
+
+**Impact**: Poor CLS scores, bad user experience.
+
+**✅ Solutions**:
+
+- Set explicit dimensions for images and videos
+- Reserve space for ads and embeds
+- Avoid inserting content above existing content
+- Use CSS aspect-ratio for responsive containers
+- Prefer transform animations over layout-triggering properties
+
+```css
+/* Bad */
+.image-container {
+  width: 100%;
+  /* height not set - causes CLS */
+}
+
+/* Good */
+.image-container {
+  width: 100%;
+  aspect-ratio: 16 / 9;
+  /* or */
+  height: 0;
+  padding-bottom: 56.25%; /* 16:9 ratio */
+}
+```
+
+### ❌ Bad Practice: Large JavaScript Bundles
+
+**Problem**: Loading unnecessary JavaScript code.
+
+**Impact**: Poor TTI, high TBT.
+
+**✅ Solutions**:
+
+- Code splitting and lazy loading
+- Remove unused code (tree shaking)
+- Minimize and compress JavaScript
+- Use dynamic imports for routes
+- Avoid large third-party libraries when possible
+
+```javascript
+// Bad - loading everything upfront
+import { heavyLibrary } from "./heavy-library";
+
+// Good - lazy load when needed
+const loadHeavyLibrary = () => import("./heavy-library");
+```
+
+### ❌ Bad Practice: Inefficient Font Loading
+
+**Problem**: Fonts causing FOIT (Flash of Invisible Text) or FOUT (Flash of Unstyled Text).
+
+**Impact**: Poor FCP, layout shifts.
+
+**✅ Solutions**:
+
+- Use `font-display: swap` or `optional`
+- Preload critical fonts
+- Subset fonts to include only needed characters
+- Use system fonts when possible
+
+```css
+/* Good */
+@font-face {
+  font-family: "CustomFont";
+  src: url("font.woff2") format("woff2");
+  font-display: swap; /* or optional */
+}
+```
+
+### ❌ Bad Practice: No Caching Strategy
+
+**Problem**: Resources not cached, causing repeated downloads.
+
+**Impact**: Slow repeat visits, poor performance.
+
+**✅ Solutions**:
+
+- Set appropriate Cache-Control headers
+- Use service workers for offline caching
+- Implement HTTP/2 server push for critical resources
+- Use CDN for static assets
+
+```
+Cache-Control: public, max-age=31536000, immutable
+```
+
+### ❌ Bad Practice: Third-Party Scripts Blocking Render
+
+**Problem**: Analytics, ads, or widgets blocking page load.
+
+**Impact**: Poor TTI, high TBT.
+
+**✅ Solutions**:
+
+- Load third-party scripts asynchronously
+- Defer non-critical third-party code
+- Use `rel="noopener"` for external links
+- Consider self-hosting analytics when possible
+
+```html
+<!-- Good -->
+<script async src="https://www.google-analytics.com/analytics.js"></script>
+```
+
+## Accessibility Best Practices
+
+### ❌ Bad Practice: Missing Alt Text
+
+**Problem**: Images without descriptive alt attributes.
+
+**Impact**: Poor accessibility score.
+
+**✅ Solution**: Always provide meaningful alt text.
+
+```html
+<!-- Bad -->
+<img src="chart.png" />
+
+<!-- Good -->
+<img src="chart.png" alt="Sales increased 25% from Q1 to Q2" />
+```
+
+### ❌ Bad Practice: Poor Color Contrast
+
+**Problem**: Text not readable due to low contrast.
+
+**Impact**: Poor accessibility score.
+
+**✅ Solution**: Ensure contrast ratio of at least 4.5:1 for normal text, 3:1 for large text.
+
+### ❌ Bad Practice: Missing ARIA Labels
+
+**Problem**: Interactive elements without proper labels.
+
+**Impact**: Poor accessibility score.
+
+**✅ Solution**: Use ARIA labels for screen readers.
+
+```html
+<!-- Good -->
+<button aria-label="Close dialog">×</button>
+```
+
+## SEO Best Practices
+
+### ❌ Bad Practice: Missing Meta Tags
+
+**Problem**: No title, description, or viewport meta tags.
+
+**Impact**: Poor SEO score.
+
+**✅ Solution**: Include essential meta tags.
+
+```html
+<!-- Good -->
+<meta charset="UTF-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<meta name="description" content="Page description" />
+<title>Page Title</title>
+```
+
+### ❌ Bad Practice: Non-Descriptive Links
+
+**Problem**: Links with generic text like "click here".
+
+**Impact**: Poor SEO score.
+
+**✅ Solution**: Use descriptive link text.
+
+```html
+<!-- Bad -->
+<a href="/about">Click here</a>
+
+<!-- Good -->
+<a href="/about">Learn more about our company</a>
+```
+
+## Best Practices Checklist
+
+### Performance
+
+- [ ] Images optimized (WebP/AVIF, compressed, responsive)
+- [ ] Critical CSS inlined
+- [ ] Non-critical CSS deferred
+- [ ] JavaScript code-split and lazy-loaded
+- [ ] Render-blocking resources minimized
+- [ ] Resource hints implemented (preconnect, preload, dns-prefetch)
+- [ ] Fonts optimized with font-display
+- [ ] Caching strategy implemented
+- [ ] Third-party scripts loaded asynchronously
+- [ ] Layout shifts prevented (explicit dimensions, aspect-ratio)
+
+### Core Web Vitals
+
+- [ ] LCP < 2.5 seconds (75th percentile)
+- [ ] FCP < 1.8 seconds (75th percentile)
+- [ ] CLS < 0.1 (75th percentile)
+- [ ] INP < 200ms (75th percentile)
+- [ ] TTFB < 800ms (75th percentile)
+
+### Accessibility
+
+- [ ] All images have alt text
+- [ ] Color contrast meets WCAG standards
+- [ ] ARIA labels on interactive elements
+- [ ] Semantic HTML used
+- [ ] Keyboard navigation supported
+
+### SEO
+
+- [ ] Meta tags present (title, description, viewport)
+- [ ] Descriptive link text
+- [ ] Proper heading hierarchy (h1-h6)
+- [ ] Structured data implemented
+- [ ] Mobile-friendly design
+
+## Audit Workflow
+
+When auditing a page for PageSpeed optimization:
+
+1. **Analyze Current State**
+
+   - Check current PageSpeed scores
+   - Identify Core Web Vitals metrics
+   - Review lab and field data differences
+
+2. **Identify Issues**
+
+   - List all performance problems
+   - Prioritize by impact (Core Web Vitals first)
+   - Categorize by type (images, JS, CSS, etc.)
+
+3. **Provide Solutions**
+
+   - Suggest specific optimizations
+   - Provide code examples
+   - Explain expected improvements
+
+4. **Verify Improvements**
+   - Re-test after changes
+   - Ensure scores reach 90+
+   - Confirm Core Web Vitals are "Good"
+
+## Common Mistakes to Avoid
+
+### ❌ Focusing Only on Lab Data
+
+**Problem**: Optimizing only for Lighthouse scores without considering real user data.
+
+**✅ Solution**: Balance both lab and field data. Field data shows real-world performance.
+
+### ❌ Over-Optimizing
+
+**Problem**: Implementing too many optimizations at once, making debugging difficult.
+
+**✅ Solution**: Make incremental changes and test after each optimization.
+
+### ❌ Ignoring Mobile Performance
+
+**Problem**: Optimizing only for desktop.
+
+**✅ Solution**: Mobile-first approach. Most users are on mobile devices.
+
+### ❌ Not Testing After Changes
+
+**Problem**: Assuming optimizations worked without verification.
+
+**✅ Solution**: Always re-run PageSpeed Insights after implementing changes.
+
+## Performance Optimization Priority
+
+1. **Critical Path**: Optimize resources needed for initial render
+2. **Core Web Vitals**: Focus on LCP, CLS, and INP first
+3. **Render-Blocking**: Eliminate blocking CSS and JS
+4. **Images**: Optimize largest contentful paint element
+5. **Third-Party**: Minimize impact of external scripts
+6. **Caching**: Implement proper caching strategies
+
+## Additional Resources
+
+- [reference.md](reference.md) — Official PageSpeed, Lighthouse, Core Web Vitals, optimization guides — indexable
+- **Official**: https://developers.google.com/speed/docs/insights/v5/about?hl=es-419
+- **PageSpeed Insights**: https://pagespeed.web.dev/
+- **Lighthouse**: Built into Chrome DevTools
+- **Web Vitals**: https://web.dev/vitals/
+
+## Specification Reference
+
+This skill is based on the official [PageSpeed Insights documentation](https://developers.google.com/speed/docs/insights/v5/about?hl=es-419) from Google Developers.
+
+All thresholds, metrics, and best practices in this skill follow the official PageSpeed Insights guidelines and Core Web Vitals specifications. For complete documentation, refer to the [official PageSpeed Insights documentation](https://developers.google.com/speed/docs/insights/v5/about?hl=es-419).

package/obj/template/.claude/skills/pagespeed-insights/reference.md

@@ -0,0 +1,50 @@
+# PageSpeed Insights — Reference & Official Documentation
+
+This file complements the pagespeed-insights skill with official documentation links for indexing.
+
+## Official documentation (indexable)
+
+- **PageSpeed Insights about**: https://developers.google.com/speed/docs/insights/v5/about?hl=es-419
+- **PageSpeed Insights (tool)**: https://pagespeed.web.dev/
+- **Lighthouse**: https://developer.chrome.com/docs/lighthouse/
+- **Core Web Vitals**: https://web.dev/vitals/
+- **Chrome User Experience Report (CrUX)**: https://developer.chrome.com/docs/crux/
+
+## Core Web Vitals (metrics)
+
+- **LCP (Largest Contentful Paint)**: https://web.dev/lcp/
+- **FCP (First Contentful Paint)**: https://web.dev/fcp/
+- **CLS (Cumulative Layout Shift)**: https://web.dev/cls/
+- **INP (Interaction to Next Paint)**: https://web.dev/inp/
+- **TTFB (Time to First Byte)**: https://web.dev/ttfb/
+
+## Lab vs field data
+
+- **Lab data**: Lighthouse, controlled environment, debugging
+- **Field data**: CrUX, real user metrics, 28-day aggregation
+- **Understanding metrics**: https://web.dev/metrics/
+
+## Performance optimization guides
+
+- **Optimize LCP**: https://web.dev/optimize-lcp/
+- **Optimize CLS**: https://web.dev/optimize-cls/
+- **Optimize INP**: https://web.dev/optimize-inp/
+- **Optimize FCP**: https://web.dev/optimize-fcp/
+- **Resource hints**: https://web.dev/preconnect-and-dns-prefetch/
+- **Image optimization**: https://web.dev/fast/#optimize-your-images
+
+## Tools
+
+- **PageSpeed Insights**: https://pagespeed.web.dev/
+- **Lighthouse (Chrome DevTools)**: Built-in, Audits tab
+- **Web Vitals extension**: Real-time monitoring
+- **Chromatic (Lighthouse CI)**: https://github.com/GoogleChrome/lighthouse-ci
+
+## Score thresholds (reminder)
+
+| Category | Good | Needs Improvement | Poor |
+|----------|------|-------------------|------|
+| Performance | 90-100 | 50-89 | 0-49 |
+| Accessibility | 90-100 | 50-89 | 0-49 |
+| Best Practices | 90-100 | 50-89 | 0-49 |
+| SEO | 90-100 | 50-89 | 0-49 |

package/obj/template/CLAUDE.md

@@ -267,15 +267,15 @@ The vendored `impeccable` skill stays untouched (Article IX). `design-ui` is the
 
 ## Article XI — Skill provenance and the baseline manifest
 
-Every skill at `.claude/skills/<slug>/SKILL.md` SHALL declare ownership in its YAML frontmatter as `owner: baseline` or `owner: user`. The build script `scripts/build-manifest.mjs` reads each `owner:` value and emits the canonical baseline-skill set into `obj/template/manifest.json` under `owners.skills` (a JSON object mapping slug → `"baseline"`). The CLI mirrors this manifest verbatim to `<target>/.claude/.baseline-manifest.json` on install. The audit at `.claude/skills/audit-baseline/audit.sh` consumes `manifest.owners.skills` as the canonical baseline-skill enumeration — the previous hard-coded `EXPECTED_SKILLS` set is removed.
+A skill at `.claude/skills/<slug>/SKILL.md` is **baseline-owned** iff its YAML frontmatter declares `owner: baseline`. Every other skill on disk — those without an `owner:` field, or those declaring `owner: user` — is user/third-party and out-of-scope of baseline audit checks. Absence-of-`owner` is the deliberate default so a project with pre-existing skills can install the baseline without annotating any of its own files. The build script `scripts/build-manifest.mjs` reads each `owner:` value and emits the canonical baseline-skill set into `obj/template/manifest.json` under `owners.skills` (a JSON object mapping slug → `"baseline"`). The CLI mirrors this manifest verbatim to `<target>/.claude/.baseline-manifest.json` on install. The audit at `.claude/skills/audit-baseline/audit.sh` consumes `manifest.owners.skills` as the canonical baseline-skill enumeration — the previous hard-coded `EXPECTED_SKILLS` set is removed.
 
 You SHALL:
 
-1. **Declare ownership.** Every new SKILL.md you author starts with `owner: baseline` (if it ships in the baseline) or `owner: user` (if it is project-local). The field appears in frontmatter directly after `name:`. Missing or invalid values fail the audit with `missing owner frontmatter` or `invalid owner=<value>`.
+1. **Declare baseline ownership only.** A SKILL.md that ships in the baseline SHALL declare `owner: baseline` in its frontmatter directly after `name:`. Authoring a user/third-party skill does NOT require any `owner:` annotation — absence is the default. Explicit `owner: user` is permitted but never required. The only frontmatter-related FAIL the audit emits is `invalid owner=<value>` (a present-but-malformed `owner:` field, e.g. typo). Missing-`owner:` is silently skipped.
 2. **Trust the manifest.** The shipped `obj/template/manifest.json` (mirrored to `<target>/.claude/.baseline-manifest.json` on install) is the canonical record of baseline-owned skills and their content hashes. You SHALL NOT maintain a separate hard-coded list of baseline-skill slugs anywhere in the codebase.
 3. **Re-derive on drift.** The audit re-derives sha256 hashes from `manifest.files` for every path under `.claude/skills/<slug>/` whose slug appears in `owners.skills`, and compares against on-disk content. Mismatches surface as `hash mismatch at <path>`. A baseline-listed slug missing from disk surfaces as `baseline skill missing`. These are hard FAIL — drift detection has no opt-out.
 4. **Preserve constitutional citation.** This Article XI SHALL remain in CLAUDE.md AND in `src/CLAUDE.template.md` (byte-equal mirror). The genesis §17 in `docs/init/seed.md` SHALL remain present, with `src/seed.template.md` mirroring it. The audit verifies both citations and reports `CLAUDE.md missing Article XI citation` or `seed.md missing §17 citation` on absence.
-5. **Exempt user skills from baseline checks.** User-owned skills (`owner: user`) are excluded from the baseline count, the names-match check, and the hash-drift check. Adding a local skill does not break the audit; it is the user's responsibility to maintain.
+5. **Out-of-scope skills don't break the audit.** Any skill on disk that doesn't declare `owner: baseline` is out-of-scope: excluded from the baseline count, the names-match check, and the hash-drift check. Installing the baseline into a project that already has its own skills is zero-friction — no per-file annotation required. Maintenance of those skills is the user's responsibility.
 
 Cryptographic supply-chain attestation, signed lock files, and per-skill aggregate merkle hashes are non-goals. The per-file `manifest.files` map already covers every file in every skill directory. A future `npx @friedbotstudio/create-baseline upgrade` subcommand will consume `manifest.owners.skills` + `manifest.files` to re-overlay baseline-owned files safely while leaving user-added or locally-customized files untouched — that subcommand is out of scope of this Article.
 

package/obj/template/docs/init/seed.md

@@ -576,9 +576,9 @@ Until `/init-project` runs, this section stays empty. Once populated, every fiel
 
 ## §17 — Skill provenance and the baseline manifest
 
-Every skill at `.claude/skills/<slug>/SKILL.md` SHALL declare ownership in its YAML frontmatter as `owner: baseline` or `owner: user`. Baseline-owned skills are those that ship with the baseline; user-owned skills are those a project adds locally. The build script `scripts/build-manifest.mjs` reads each `owner:` value at release time and emits the canonical baseline-skill set into `obj/template/manifest.json` under `owners.skills` (a JSON object mapping slug → `"baseline"`). The CLI mirrors this manifest verbatim to `<target>/.claude/.baseline-manifest.json` on `freshInstall`/`forceInstall`/`merge`.
+A skill at `.claude/skills/<slug>/SKILL.md` is **baseline-owned** iff its YAML frontmatter declares `owner: baseline`. Baseline-owned skills are those that ship with the baseline; every other skill on disk — those without an `owner:` field, or those declaring `owner: user` — is user/third-party and out-of-scope of baseline audit checks. Absence-of-`owner` is the deliberate default so a project that already has its own skills can install the baseline without annotating any of those files. The build script `scripts/build-manifest.mjs` reads each `owner:` value at release time and emits the canonical baseline-skill set into `obj/template/manifest.json` under `owners.skills` (a JSON object mapping slug → `"baseline"`). The CLI mirrors this manifest verbatim to `<target>/.claude/.baseline-manifest.json` on `freshInstall`/`forceInstall`/`merge`.
 
-The audit at `.claude/skills/audit-baseline/audit.sh` consumes `manifest.owners.skills` as the canonical baseline-skill enumeration (replacing the previous hard-coded `EXPECTED_SKILLS` set). For every baseline-owned skill, the audit re-derives sha256 hashes from `manifest.files` and compares against on-disk content; a mismatch is reported as `hash mismatch at <path>` against the named slug. A baseline skill present in the manifest but absent from disk is reported as `baseline skill missing`. A SKILL.md missing the `owner:` field, or carrying an invalid value, is reported as `missing owner frontmatter` or `invalid owner=<value>`. User-owned skills (`owner: user`) are excluded from the baseline count and the names-match check, so adding a local skill does not break the audit.
+The audit at `.claude/skills/audit-baseline/audit.sh` consumes `manifest.owners.skills` as the canonical baseline-skill enumeration (replacing the previous hard-coded `EXPECTED_SKILLS` set). For every baseline-owned skill, the audit re-derives sha256 hashes from `manifest.files` and compares against on-disk content; a mismatch is reported as `hash mismatch at <path>` against the named slug. A baseline skill present in the manifest but absent from disk is reported as `baseline skill missing`. A SKILL.md whose `owner:` field is present but carries an invalid value (anything other than `baseline` or `user`) is reported as `invalid owner=<value>`. SKILL.md files without an `owner:` field are treated as user/third-party and silently skipped — they are excluded from the baseline count, the names-match check, and the hash-drift check, so installing the baseline into a project that already has its own skills never breaks the audit.
 
 The audit also verifies constitutional citation: CLAUDE.md SHALL contain the literal string "Article XI" and a reference to the manifest, and `docs/init/seed.md` SHALL contain "§17" and a manifest reference. Missing citations trigger FAIL with `CLAUDE.md missing Article XI citation` or `seed.md missing §17 citation`.
 

package/obj/template/manifest.json

@@ -1,6 +1,6 @@
 {
   "manifest_version": 2,
-  "generated_at": "2026-05-14T15:52:13.061Z",
+  "generated_at": "2026-05-14T22:27:15.062Z",
   "files": {
     ".claude/agents/swarm-worker.md": "1735a220f268c9765cb22e0567b728803f2edd7776cbde51dd017a9f062ae41f",
     ".claude/bin/LICENSE": "a8dcf2775ab71a58c7d4cc935e3a8e9974e87bb7d6082ee25ef52f8140be8e07",
@@ -15,7 +15,6 @@
     ".claude/hooks/env_guard.sh": "76ffc98fa9a2709526715132981699e46043183e2b1d043a05744a40384d1361",
     ".claude/hooks/git_commit_guard.sh": "1a78799f35cae7b52ee29d8adcddc5cd29427822c223a3be6e0d181f1e8e71c2",
     ".claude/hooks/harness_continuation.sh": "81b40138a66b24d93fcd8fde57f2f21804667952f466d84c2af7c9307c75b117",
-    ".claude/hooks/lib/__pycache__/resume_writer.cpython-314.pyc": "4c9afd22f475848f4007111bf325b406924faef16a6e90e963399febf3075cab",
     ".claude/hooks/lib/common.sh": "2c72b867acf08550f62f80c6b57024d35edd74260a9fd7ac6c709e71fd812319",
     ".claude/hooks/lib/resume_writer.py": "9592fb72de966cb797e51322fbf0160a6784de34934bd6587768689a34bd03b5",
     ".claude/hooks/lint_runner.sh": "267e08dbd9af246c0af124c32ad4aeac48dfe20ac926244ed89855deb7ff7940",
@@ -50,7 +49,7 @@
     ".claude/skills/archive/SKILL.md": "5174e8b72ab1e830912c231052d1e535023d58f0808434fe1d4abce305b80318",
     ".claude/skills/archive/archive.sh": "29f5b3c8870d0665ce624c6d1b5770f691f1d19f82a201767d5685fc3b0a0b58",
     ".claude/skills/audit-baseline/SKILL.md": "86e9955a99ade89074571320b2b9b0780bc033d201968f62edcca35d9e25f7cb",
-    ".claude/skills/audit-baseline/audit.sh": "9e5f20988c0e53406307e44d297d5030a8bf85a2b992167a193b4d8efb076c30",
+    ".claude/skills/audit-baseline/audit.sh": "76eb4e9e58c31fc4d7258427473b1e4cdf7c3a63cbb065b4139fe4a1b4f1eee7",
     ".claude/skills/brd/SKILL.md": "260e5d18396de21b6842ad0bc5fe74b0e124f3c2e2a4ac2867eeb543c7c2c0a3",
     ".claude/skills/brd/template.md": "be4095b4bed70fcebc821ad92b0217db4fee1afb9a341a9e704d2c1869ec6f43",
     ".claude/skills/chore/SKILL.md": "66efdcf992a7e56db97c0c1e81abe229263fd4bba976e1f21a23cf4dca705920",
@@ -76,6 +75,22 @@
     ".claude/skills/design-ui/references/state-machine.md": "e15b121bc4dbb5fb2926d9dca8dc08d03c6b60875b420ca50898f1de5aaa7c9e",
     ".claude/skills/document/SKILL.md": "7345488fe50923c273dfdf3277ec7251fee9184bc7de1a12192255b5ad183fda",
     ".claude/skills/documentation/SKILL.md": "456160c1a3398cfece91b6696d0c7f1fcb1196ea5e101acb9a0e3050f2462a5d",
+    ".claude/skills/google-analytics/SKILL.md": "f5d8c52c103e4e1bdbb6bfdda962aad198064ced701c20df753d77ba4603547c",
+    ".claude/skills/google-analytics/references/audiences.md": "cdae62b0f40e82a60f96a6bd0e77798c6118beaebe812961e8c9d4c3242b227f",
+    ".claude/skills/google-analytics/references/bigquery.md": "fadc3efdd200a0bc43df4b698d46bc93e82111d8553b363d1e49ceb15bcdffce",
+    ".claude/skills/google-analytics/references/custom-dimensions.md": "ac9e88c69fd8eb2a0bf1ae8f3daac42c6d92caa338ce2fa77a50bf2fe947dbc4",
+    ".claude/skills/google-analytics/references/custom-events.md": "442ce8c1e7d89cb2206a85b02b287748e3e226d67cab571bc6f2a3ea520bc434",
+    ".claude/skills/google-analytics/references/data-management.md": "1f9e80e0855937dc082d63535188fc1e7547273e626d0a3ef03c0487b42045bb",
+    ".claude/skills/google-analytics/references/debugview.md": "f2b050db37b7927de99b0196deb7cb94d8ecb1a6668c9e08bec4f57816646e90",
+    ".claude/skills/google-analytics/references/events-fundamentals.md": "acdeb349be2f468ba634d686691aeda0ce932db93b4872b9cd35685dcd3f31cf",
+    ".claude/skills/google-analytics/references/gtag.md": "bef0556071bc645656d0634c26c3bad20d39517cb14689bb11e9d9bedf4f6ab8",
+    ".claude/skills/google-analytics/references/gtm-integration.md": "3c95c7b64fbbd688907cd558c3c4d265b99c7178284b97e376334d802d11c860",
+    ".claude/skills/google-analytics/references/measurement-protocol.md": "a5b644a5ca586173e399c229a47aad571991389232320a0f9e6baf1d4be619fb",
+    ".claude/skills/google-analytics/references/privacy.md": "09e2db4ce4d990f4f1ff51c0e3bca08a364cba711f83f48103f69f9db427fa18",
+    ".claude/skills/google-analytics/references/recommended-events.md": "0dccd2084060bfb3fd28476b9c0c9a6e2b8f51ce57ecf4fc32d7f82a8964b1b4",
+    ".claude/skills/google-analytics/references/reporting.md": "37cb7cfd1dd547e86a41664ffe13893ef138194a2288d1a2c43c9195e8ec609f",
+    ".claude/skills/google-analytics/references/setup.md": "26743b72341a5658e73c1f070b924de0f11b1681af06164cb13c19f2047a1087",
+    ".claude/skills/google-analytics/references/user-tracking.md": "5a945df2a575291c6b35d24830b497915c82a843a93ee133577f1deda93f6d75",
     ".claude/skills/harness/SKILL.md": "f758faec70974e61b558e93055f8267f39f51816759a645b89a28ff362e18eb6",
     ".claude/skills/humanizer/SKILL.md": "398beef0cabe34df435972a13fb9ef21be74d942f93321b220a5dd393d554e40",
     ".claude/skills/humanizer/references/ai-writing-detection.md": "e896c1b31f7af57b8cda81df6ded6e9d7e9ab742a0f5fdfc73f88a6be2e78f2b",
@@ -139,6 +154,11 @@
     ".claude/skills/memory-flush/SKILL.md": "ad971b4aef6820e0ae926812e499ed65496f6b14de57db04a5e9ebc440754631",
     ".claude/skills/memory-flush/sweep.py": "ebca5b2e09c021a61f434822cf693d552407cf52f753979dc403310666d490b6",
     ".claude/skills/memory-flush/tests/run.sh": "aa20d8f6057c3d34fd72ab1aca2c2dc498dede36497f68e5576547a755c8c315",
+    ".claude/skills/optimize-seo/SKILL.md": "b389dc604346220d5a0a59c8f41c058c192c58a35bbff831fbc4c7f9e8c1b386",
+    ".claude/skills/optimize-seo/scripts/pagespeed.mjs": "8bef62078833139f9175c175339d1fc0eb635a5eeaa2a3100543928ef91869e4",
+    ".claude/skills/pagespeed-insights/LICENSE.md": "10ee2ded8c2ae373a65aacfa51f2bf540d5f20d418fc7a5595a5ccb06cde2738",
+    ".claude/skills/pagespeed-insights/SKILL.md": "ab53af083929fbb28af0ad2c9ee1fcc51dec63c642ebc237c475b3ea9bde7c59",
+    ".claude/skills/pagespeed-insights/reference.md": "afa03220b772ea8d6393f7366bbd6d90200c0b56585ccb2bb714e622af07345f",
     ".claude/skills/prose/SKILL.md": "7cfc7d4fd34d7256367eedf17c5f5b5cdb67baec72033f905dcfb715366a1849",
     ".claude/skills/rca/SKILL.md": "e5d1285df6d627052cfd62c3c8900bbd847ae92b37d245e8d6c2cc34c7fc32c5",
     ".claude/skills/rca/template.md": "8466f5737a0aeb88bcb73d4d4065293e2ff59f0c0e19de4082598d4e920caeb9",
@@ -168,8 +188,8 @@
     ".claude/skills/triage/SKILL.md": "1a26797795bec07d57bf61ced22c1d271124ec32ae858f4cb10e0cd3a78cfdf3",
     ".claude/skills/verify/SKILL.md": "fcddba67cf7f3623fc8f8ae142303b16b9db0c9fc1652bc920e16c56fe4c7864",
     ".mcp.json": "8ebb7966045486187bbdf9bac643e690c4fbc7a9a70a8345e3665ba72fa19b96",
-    "CLAUDE.md": "af8302a7224a751acd1f95b0dbad0910f3246f77b5bb5f0bd59d2cf74095d205",
-    "docs/init/seed.md": "8027e001b953c3a6c245c14652a1c38c5a4de10b6ba4d53f870c53c7c76187f6"
+    "CLAUDE.md": "1bdd48d3f69c491a8dddac7b61adb72b84a54ad927a048e48e8537c2a86ef4e2",
+    "docs/init/seed.md": "76f059186b31c8e01724f3dce4c70a71a20594ee301073458c611655a6c208d9"
   },
   "owners": {
     "skills": {
@@ -210,5 +230,6 @@
       "triage": "baseline",
       "verify": "baseline"
     }
-  }
+  },
+  "build_id": "gha-25889207503"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@friedbotstudio/create-baseline",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Zero-dependency Node CLI scaffolder that materializes the Claude Code baseline (hooks, skills, commands, MCP servers, governance docs) into a target project. Run via `npx @friedbotstudio/create-baseline <target>`.",
   "type": "module",
   "bin": {
@@ -22,7 +22,7 @@
     "build:site": "eleventy",
     "dev:site": "eleventy --serve --port=4321",
     "publish:check": "bash scripts/publish-check.sh",
-    "publish:precheck": "npm publish --dry-run",
+    "publish:precheck": "npm pack --dry-run",
     "publish:files-diff": "node scripts/check-files-diff.mjs",
     "publish:smoke": "node scripts/smoke-tarball.mjs",
     "release": "semantic-release"
@@ -38,6 +38,11 @@
     "type": "git",
     "url": "git+https://github.com/friedbotstudio/baseline.git"
   },
+  "author": {
+    "name": "Friedbot Studio Pvt Ltd",
+    "email": "hello@friedbotstudio.com"
+  },
+  "homepage": "https://baseline.friedbotstudio.com",
   "devDependencies": {
     "@11ty/eleventy": "3.1.5",
     "@semantic-release/changelog": "6.0.3",