Skip to content

ChuluuMGL/proposal-skill

proposal

Verified

Create, revise, or audit commercial proposals as editable PowerPoint, interactive HTML, or PDF, with proposal logic, case evidence, scope and pricing, presenter scripts, and format-specific validation. Use for client proposals, pitches, tenders, and proposal revisions, rather than general marketing websites.

FileKindSize
SKILL.mdskill md8.1 KB
agents/openai.yamlconfig376 B
assets/demo/cover-premium-boardroom-v2.pngbinary118.6 KB
assets/demo/cover-premium-boardroom.pngbinary118.6 KB
assets/demo/dense-page-v2.pngbinary226.1 KB
assets/demo/dense-page.pngbinary226.1 KB
assets/demo/editorial-brand-3up.pngbinary228.5 KB
assets/demo/editorial-brand-cover-v2.pngbinary139.7 KB
assets/demo/editorial-brand-cover.pngbinary139.7 KB
assets/demo/premium-boardroom-3up.pngbinary520.0 KB
assets/demo/showcase-overview-v2.pngbinary183.0 KB
assets/demo/showcase-overview.pngbinary183.0 KB
assets/demo/tech-launch-3up.pngbinary188.0 KB
assets/demo/tech-launch-page-v2.pngbinary137.9 KB
assets/demo/tech-launch-page.pngbinary137.9 KB
assets/minimal-proposal-template.pptxbinary52.8 KB
examples/final-polish-anonymized-case.mdmarkdown1.1 KB
examples/proposal-revisions.mdmarkdown3.4 KB
references/argument-traceability.mdmarkdown2.4 KB
references/brief-compliance.mdmarkdown4.2 KB
references/client-facing-copy.mdmarkdown1.9 KB
references/external-capability-adapters.mdmarkdown859 B
references/final-polish-workflow.mdmarkdown3.3 KB
references/font-system.mdmarkdown6.0 KB
references/iteration-learning.mdmarkdown2.1 KB
references/layout-rhythm.mdmarkdown12.6 KB
references/manual-edit-protection.mdmarkdown1.5 KB
references/output-contract.mdmarkdown8.6 KB
references/page-types.mdmarkdown4.6 KB
references/palette-library.mdmarkdown7.2 KB
references/proposal-routes.mdmarkdown4.9 KB
references/quality-check.mdmarkdown12.7 KB
references/quality-levels.mdmarkdown1.1 KB
references/runtime-compatibility.mdmarkdown6.3 KB
references/story-map-and-sequencing.mdmarkdown1.0 KB
references/style-template-strategy.mdmarkdown16.9 KB
references/visual-finish-spec.mdmarkdown1.4 KB
references/visual-system-card.mdmarkdown3.0 KB
references/visual-system.mdmarkdown9.4 KB
references/web-interactions.mdmarkdown3.5 KB
references/web-proposals.mdmarkdown5.4 KB
references/workflow.mdmarkdown16.6 KB
scripts/audit_html_demo.mjsscript5.3 KB
scripts/audit_proposal_pptx.pyscript13.2 KB
scripts/build_revision_ledger.pyscript2.4 KB
scripts/check_release_consistency.pyscript2.7 KB
scripts/compare_protected_elements.pyscript5.3 KB
templates/README.mdmarkdown2.7 KB
templates/engine.cssother4.2 KB
templates/premium-boardroom.theme.cssother7.0 KB
templates/style-specs/README.mdmarkdown1005 B
templates/style-specs/consumer-lifestyle.mdmarkdown3.1 KB
templates/style-specs/editorial-brand.mdmarkdown3.1 KB
templates/style-specs/premium-boardroom.mdmarkdown3.5 KB
templates/style-specs/tech-launch.mdmarkdown3.0 KB
templates/tech-launch.theme.cssother2.2 KB
templates/web-components/README.mdmarkdown1.7 KB
templates/web-components/components.cssother6.0 KB
templates/web-components/components.jsscript5.0 KB
templates/web-components/concept-detail.svgother921 B
templates/web-components/concept-system.svgother939 B
templates/web-components/index.htmlother6.3 KB

scripts/audit_html_demo.mjs

View on GitHub
#!/usr/bin/env node
/**
 * audit_html_demo.mjs — rendered-visual QA for proposal-ppt HTML demos.
 *
 * The pptx audit (audit_proposal_pptx.py) checks the .pptx file structurally,
 * but real line-wrapping only happens inside a renderer. This script renders an
 * HTML style demo headlessly and reports two classes of defect that a boundary
 * check alone misses and that agents cannot reliably self-verify:
 *
 *   1. element-to-element text overlap (reads as a broken deck)
 *   2. boundary overflow / internal clipping
 *
 * Requires Playwright. Set PLAYWRIGHT_MODULE_PATH to point at a specific
 * Playwright install (e.g. a runtime-bundled node_modules/playwright);
 * otherwise a normal `playwright` require is attempted.
 *
 * Usage:
 *   node scripts/audit_html_demo.mjs path/to/demo.html
 *   node scripts/audit_html_demo.mjs path/to/demo.html --render out/   # also save PNGs
 *
 * Exit code: 0 if clean, 1 if any issue found.
 */

import path from "node:path";
import fs from "node:fs";
import { fileURLToPath } from "node:url";
import { createRequire } from "node:module";

const require = createRequire(import.meta.url);
function loadPlaywright() {
  const candidates = [process.env.PLAYWRIGHT_MODULE_PATH, "playwright"].filter(Boolean);
  for (const c of candidates) {
    try { return require(c).chromium; } catch { /* try next */ }
  }
  console.error("Playwright not found. Install with: npm i -D playwright && npx playwright install chromium");
  process.exit(2);
}

const args = process.argv.slice(2);
const htmlArg = args.find(a => !a.startsWith("--"));
const renderIdx = args.indexOf("--render");
const renderDir = renderIdx >= 0 ? args[renderIdx + 1] : undefined;
if (!htmlArg) {
  console.error("Usage: audit_html_demo.mjs <demo.html> [--render out/]");
  process.exit(2);
}
const htmlPath = path.resolve(htmlArg);
if (!fs.existsSync(htmlPath)) {
  console.error(`file not found: ${htmlPath}`);
  process.exit(2);
}

const chromium = loadPlaywright();
const browser = await chromium.launch({ headless: true });
const page = await browser.newPage({ viewport: { width: 2048, height: 1220 }, deviceScaleFactor: 1 });
await page.goto(`file://${htmlPath}`, { waitUntil: "networkidle" });
await page.evaluate(() => document.fonts && document.fonts.ready);
await page.waitForTimeout(600);

const findings = await page.evaluate(() => {
  const out = [];
  const isLeafText = (el) =>
    el.children.length === 0 && (el.textContent || "").trim().length > 0;
  const slides = document.querySelectorAll(".slide");
  if (!slides.length) return { slides: 0, findings: out };
  slides.forEach((slide, si) => {
    const sr = slide.getBoundingClientRect();
    const leaves = [];
    slide.querySelectorAll("*").forEach((el) => {
      const r = el.getBoundingClientRect();
      if (r.width <= 0 || r.height <= 0) return;
      const cls = typeof el.className === "string" ? el.className : "";
      const label = `${el.tagName.toLowerCase()}.${cls}`.replace(/\s+/g, ".");
      const st = getComputedStyle(el);
      const clips = st.overflowX !== "visible" || st.overflowY !== "visible";
      const outside = r.left < sr.left - 1 || r.top < sr.top - 1 || r.right > sr.right + 1 || r.bottom > sr.bottom + 1;
      const overflow = clips && (el.scrollWidth > el.clientWidth + 2 || el.scrollHeight > el.clientHeight + 2);
      if (outside || overflow) {
        out.push({
          slide: si + 1, kind: outside ? "boundary-out" : "clipped",
          el: label,
          text: (el.textContent || "").trim().slice(0, 30),
        });
      }
      if (isLeafText(el)) leaves.push({ el, r, label });
    });
    // element-to-element overlap (skip ancestor/descendant pairs)
    for (let i = 0; i < leaves.length; i++) {
      for (let j = i + 1; j < leaves.length; j++) {
        const a = leaves[i], b = leaves[j];
        if (a.el.contains(b.el) || b.el.contains(a.el)) continue;
        const ox = Math.min(a.r.right, b.r.right) - Math.max(a.r.left, b.r.left);
        const oy = Math.min(a.r.bottom, b.r.bottom) - Math.max(a.r.top, b.r.top);
        if (ox > 6 && oy > 6) {
          out.push({
            slide: si + 1, kind: "overlap",
            a: a.label, b: b.label,
            aText: (a.el.textContent || "").trim().slice(0, 20),
            bText: (b.el.textContent || "").trim().slice(0, 20),
            px: Math.round(ox), py: Math.round(oy),
          });
        }
      }
    }
  });
  return { slides: slides.length, findings: out };
});

if (renderDir) {
  fs.mkdirSync(renderDir, { recursive: true });
  const shells = await page.locator(".slide-shell").all();
  for (let i = 0; i < shells.length; i++) {
    await shells[i].screenshot({ path: path.join(renderDir, `slide-${String(i + 1).padStart(2, "0")}.png`) });
  }
}

await browser.close();

console.log(`\n=== audit: ${path.basename(htmlPath)} (${findings.slides} slide(s)) ===`);
if (!findings.findings.length) {
  console.log("  no boundary, clipping, or element-overlap issues found.");
  console.log("=== result: CLEAN ===");
  process.exit(0);
}
for (const f of findings.findings) {
  if (f.kind === "overlap") {
    console.log(`  [ERROR] slide ${f.slide}: overlap ${f.px}×${f.py}px  '${f.aText}' ↔ '${f.bText}'`);
  } else {
    console.log(`  [ERROR] slide ${f.slide}: ${f.kind}  <${f.el}>  '${f.text}'`);
  }
}
console.log(`=== result: ${findings.findings.length} issue(s) found ===`);
process.exit(1);
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 469kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 469kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 469kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall