Skip to content

heymegabyte/agent-skills / 15-site-generation

site-generation

Unverified

End-to-end AI website generation pipeline. Claude Opus 4.8 emits Bolt-style <boltArtifact> envelopes (multi-file, plan-first) that customize Vite+React+Tailwind templates from pre-researched business data. Pre-research via APIs, media acquisition, brand extraction, visual inspection via GPT Image 2 vision, R2 upload (per-file content-type by extension), D1 status updates. Supports all business types: SaaS, portfolio, non-profit, restaurant, salon, medical, legal, retail, tech.

FileKindSize
SKILL.mdskill md11.7 KB
_real-ua.mjsscript1.4 KB
blog-import.mjsscript10.5 KB
bolt-artifact-protocol.mdmarkdown8.4 KB
build-breaking-rules.mdmarkdown86.0 KB
build-image-redirects.mjsscript3.4 KB
build-prompts.mdmarkdown86.3 KB
check-routes.shexecutablescript904 B
domain-features.mdmarkdown17.1 KB
enhance-blog-posts.mjsscript12.9 KB
homepage-block-library.mdmarkdown12.6 KB
local-seo.mdmarkdown7.6 KB
media-acquisition.mdmarkdown39.2 KB
non-technical-owner-onboarding.mdmarkdown8.3 KB
page-set-expansion.mdmarkdown19.1 KB
pseo-templates.mdmarkdown13.3 KB
quality-gates.mdmarkdown46.6 KB
research-pipeline.mdmarkdown20.5 KB
scan-assets.mjsscript3.0 KB
small-business-mode.mdmarkdown9.6 KB
source-fidelity-loop.mdmarkdown10.0 KB
squarespace-full-crawl.mjsscript2.8 KB
template-improvements-100.mdmarkdown15.0 KB
template-system.mdmarkdown39.7 KB
validate-assets.mjsscript5.0 KB
validate-banned-slop.mjsscript4.6 KB
validate-brand-colors.mjsexecutablescript6.1 KB
validate-citations.mjsscript6.0 KB
validate-color-contrast.mjsscript5.2 KB
validate-favicon-set.mjsscript4.9 KB
validate-html-entities.mjsscript3.4 KB
validate-image-relevance.mjsscript6.1 KB
validate-internal-links.mjsscript4.3 KB
validate-jsonld-schema.mjsscript5.1 KB
validate-nap-consistency.mjsexecutablescript8.0 KB
validate-page-count.mjsscript4.1 KB
validate-page-set-completeness.mjsscript9.3 KB
validate-photo-authenticity.mjsexecutablescript10.0 KB
validate-pwa-kit.mjsscript7.0 KB
validate-route-metadata.mjsscript7.3 KB
validate-source-fidelity.mjsscript6.0 KB
validate-typography.mjsscript4.0 KB
verticals/local-business-site.mdmarkdown3.8 KB
verticals/nonprofit-site.mdmarkdown3.3 KB
verticals/restaurant-site.mdmarkdown2.6 KB

validate-citations.mjs

View on GitHub
#!/usr/bin/env node
// validate-citations.mjs — APA 7th-ed citation integrity gate (rules/citations.md)
// Every (Author, Year) inline citation must have matching reference list entry.
// Scans dist HTML for inline citations + reference list (in <ol class="references">,
// <section id="references">, or <References>... pattern) and verifies bidirectional
// integrity: every inline cite has a list entry; every list entry is cited at least once.
// Confidence rule: claims with confidence>=0.85 must have ≥2 corroborating cites.
// Builds atop validate-banned-slop.mjs (which catches unsourced numbers); this validates
// the cite-to-reference graph after citations are present.
// Usage: node validate-citations.mjs <build-dir>
// Exit 0 = pass, exit 1 = fail.

import { readdirSync, readFileSync, statSync, existsSync } from 'node:fs';
import { join, relative, resolve } from 'node:path';

const BUILD = resolve(process.argv[2] || '.');
const DIST = existsSync(join(BUILD, 'dist')) ? join(BUILD, 'dist') : BUILD;

if (!existsSync(DIST)) {
  console.error(`[validate-citations] dist dir not found: ${DIST}`);
  process.exit(1);
}

function walkHtml(dir) {
  const out = [];
  for (const e of readdirSync(dir)) {
    if (e === 'node_modules' || e === '.git') continue;
    const p = join(dir, e);
    if (statSync(p).isDirectory()) out.push(...walkHtml(p));
    else if (e.toLowerCase().endsWith('.html')) out.push(p);
  }
  return out;
}

function stripHtml(html) {
  return html.replace(/<script\b[^>]*>[\s\S]*?<\/script>/gi, ' ').replace(/<style\b[^>]*>[\s\S]*?<\/style>/gi, ' ').replace(/<[^>]+>/g, ' ').replace(/\s+/g, ' ').trim();
}

const failures = [];
const warnings = [];
const htmlFiles = walkHtml(DIST);

// APA 7 inline cite shapes:
// (Smith, 2024) | (Smith & Lee, 2024) | (Smith et al., 2024) | (Smith, 2024, p. 47) | (Smith, 2024a)
const INLINE_CITE_RE = /\(([A-Z][A-Za-z'.-]+(?:\s+(?:&|et\s+al\.?|[A-Z][A-Za-z'.-]+))*?),\s*(\d{4}[a-z]?)(?:,\s*pp?\.\s*\d+(?:-\d+)?)?\)/g;

// Reference list entry shape (loose): "Smith, J. (2024). Title..."
// Anchor on "Lastname, Initials. (Year)." or "Lastname, Initials., & Lastname, Initials. (Year)."
const REF_ENTRY_RE = /([A-Z][A-Za-z'.-]+(?:,\s*[A-Z]\.(?:\s*[A-Z]\.)*)?(?:,?\s*(?:&|and)\s*[A-Z][A-Za-z'.-]+(?:,\s*[A-Z]\.(?:\s*[A-Z]\.)*)?)*)\s*\.\s*\((\d{4}[a-z]?)\)\./g;

const inlineCitesGlobal = new Map();   // key: "Smith2024" -> [{file, full}, ...]
const referenceEntries = new Set();    // key: "Smith2024"

function lastnameKey(authorPart) {
  // Take first surname only; strip "et al."
  const cleaned = authorPart.replace(/\s+et\s+al\.?/i, '').replace(/\s*&.*$/, '').replace(/\s*,\s*[A-Z]\.\S*$/, '');
  return cleaned.trim().split(/\s+/).pop().toLowerCase();
}

let pagesWithRefs = 0;
let pagesWithCites = 0;

for (const file of htmlFiles) {
  const rel = relative(DIST, file);
  const html = readFileSync(file, 'utf8');
  const text = stripHtml(html);

  // 1. inline cites
  INLINE_CITE_RE.lastIndex = 0;
  let m;
  let pageHadCite = false;
  while ((m = INLINE_CITE_RE.exec(text)) !== null) {
    pageHadCite = true;
    const key = `${lastnameKey(m[1])}${m[2]}`;
    if (!inlineCitesGlobal.has(key)) inlineCitesGlobal.set(key, []);
    inlineCitesGlobal.get(key).push({ file: rel, full: m[0] });
  }
  if (pageHadCite) pagesWithCites++;

  // 2. reference list entries — only count when in a "References"/"Bibliography" section
  const hasRefSection = /<(?:section|ol|div|aside|footer)[^>]*(?:class|id)=["'][^"']*(?:references|bibliography|sources|citations)[^"']*["'][^>]*>([\s\S]*?)<\/(?:section|ol|div|aside|footer)>/i.test(html) || /<h[1-6][^>]*>\s*(?:References|Bibliography|Sources|Citations)\s*<\/h[1-6]>([\s\S]*)/i.test(html);
  if (hasRefSection) {
    pagesWithRefs++;
    REF_ENTRY_RE.lastIndex = 0;
    let r;
    while ((r = REF_ENTRY_RE.exec(text)) !== null) {
      const key = `${lastnameKey(r[1])}${r[2]}`;
      referenceEntries.add(key);
    }
  }
}

// 3. Bidirectional integrity check
if (inlineCitesGlobal.size > 0 && referenceEntries.size === 0) {
  failures.push(`${inlineCitesGlobal.size} inline citation key(s) found across ${pagesWithCites} pages, but 0 reference list entries detected — every site with citations needs a References section`);
}

for (const [key, refs] of inlineCitesGlobal) {
  if (!referenceEntries.has(key)) {
    failures.push(`inline citation "${refs[0].full}" (key=${key}) has no matching reference list entry — first seen in ${refs[0].file}`);
  }
}

for (const key of referenceEntries) {
  if (!inlineCitesGlobal.has(key)) {
    warnings.push(`reference list entry "${key}" is not cited anywhere in body — orphan reference`);
  }
}

// 4. URL/DOI check on reference entries (heuristic — references should include DOI or URL)
if (referenceEntries.size > 0) {
  let withLinks = 0;
  for (const file of htmlFiles) {
    const html = readFileSync(file, 'utf8');
    if (!/(references|bibliography|sources)/i.test(html)) continue;
    // count <a> tags within references/bibliography sections
    const refSection = html.match(/(?:references|bibliography|sources)[\s\S]{0,8000}/i);
    if (refSection && /<a\s+[^>]*href=["']https?:\/\//i.test(refSection[0])) withLinks++;
  }
  if (withLinks === 0 && pagesWithRefs > 0) {
    warnings.push(`${pagesWithRefs} pages have a References section but no <a href> links — APA 7 entries should include DOI or URL`);
  }
}

if (warnings.length) {
  console.warn(`\n[validate-citations] ${warnings.length} warnings:`);
  warnings.slice(0, 20).forEach((w) => console.warn(`  ⚠ ${w}`));
}
if (failures.length) {
  console.error(`\n[validate-citations] ${failures.length} failures:`);
  failures.slice(0, 30).forEach((f) => console.error(`  ✗ ${f}`));
  if (failures.length > 30) console.error(`  ...+${failures.length - 30} more`);
  console.error('\n[validate-citations] BUILD GATE FAILED — see rules/citations.md');
  process.exit(1);
}
console.log(`[validate-citations] ✓ ${inlineCitesGlobal.size} unique inline cites all matched to ${referenceEntries.size} reference entries across ${htmlFiles.length} pages.`);
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall