Skip to content

balsm-health/website / .claude/skills/impeccable

impeccable

Flagged

Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.

FileKindSize
SKILL.mdskill md19.3 KB
reference/adapt.mdmarkdown9.9 KB
reference/animate.mdmarkdown10.1 KB
reference/audit.mdmarkdown7.1 KB
reference/bolder.mdmarkdown6.3 KB
reference/brand.mdmarkdown10.2 KB
reference/clarify.mdmarkdown10.4 KB
reference/codex.mdmarkdown6.8 KB
reference/colorize.mdmarkdown13.2 KB
reference/craft.mdmarkdown11.7 KB
reference/critique.mdmarkdown35.3 KB
reference/delight.mdmarkdown9.5 KB
reference/distill.mdmarkdown5.5 KB
reference/document.mdmarkdown27.2 KB
reference/extract.mdmarkdown3.3 KB
reference/harden.mdmarkdown8.4 KB
reference/hooks.mdmarkdown7.4 KB
reference/init.mdmarkdown12.4 KB
reference/interaction-design.mdmarkdown6.4 KB
reference/layout.mdmarkdown8.5 KB
reference/live.mdmarkdown58.3 KB
reference/onboard.mdmarkdown7.6 KB
reference/optimize.mdmarkdown7.4 KB
reference/overdrive.mdmarkdown8.8 KB
reference/polish.mdmarkdown12.7 KB
reference/product.mdmarkdown3.7 KB
reference/quieter.mdmarkdown4.7 KB
reference/shape.mdmarkdown11.1 KB
reference/typeset.mdmarkdown13.9 KB
scripts/command-metadata.jsonconfig7.8 KB
scripts/context-signals.mjsscript7.9 KB
scripts/context.mjsscript10.3 KB
scripts/critique-storage.mjsscript8.8 KB
scripts/detect-csp.mjsscript6.6 KB
scripts/detect.mjsscript620 B
scripts/detector/browser/injected/index.mjsscript75.0 KB
scripts/detector/cli/main.mjsscript10.8 KB
scripts/detector/design-system.mjsscript24.1 KB
scripts/detector/detect-antipatterns-browser.jsscript211.7 KB
scripts/detector/detect-antipatterns.mjsscript1.8 KB
scripts/detector/engines/browser/detect-url.mjsscript9.7 KB
scripts/detector/engines/regex/detect-text.mjsscript23.9 KB
scripts/detector/engines/static-html/css-cascade.mjsscript33.6 KB
scripts/detector/engines/static-html/detect-html.mjsscript9.7 KB
scripts/detector/engines/visual/screenshot-contrast.mjsscript6.4 KB
scripts/detector/findings.mjsscript363 B
scripts/detector/node/file-system.mjsscript6.7 KB
scripts/detector/profile/profiler.mjsscript4.4 KB
scripts/detector/registry/antipatterns.mjsscript18.2 KB
scripts/detector/rules/checks.mjsscript113.1 KB
scripts/detector/shared/color.mjsscript4.4 KB
scripts/detector/shared/constants.mjsscript4.1 KB
scripts/detector/shared/page.mjsscript252 B
scripts/hook-admin.mjsscript22.8 KB
scripts/hook-before-edit.mjsscript16.2 KB
scripts/hook-lib.mjsscript54.7 KB
scripts/hook.mjsscript2.0 KB
scripts/lib/design-parser.mjsscript25.2 KB
scripts/lib/impeccable-config.mjsscript21.0 KB
scripts/lib/impeccable-paths.mjsscript3.8 KB
scripts/lib/is-generated.mjsscript2.2 KB
scripts/live-accept.mjsscript29.6 KB
scripts/live-browser-dom.jsscript4.2 KB
scripts/live-browser-session.jsscript3.2 KB
scripts/live-browser.jsscript423.7 KB
scripts/live-commit-manual-edits.mjsscript41.1 KB
scripts/live-complete.mjsscript2.9 KB
scripts/live-copy-edit-agent.mjsscript28.2 KB
scripts/live-discard-manual-edits.mjsscript1.6 KB
scripts/live-inject.mjsscript22.1 KB
scripts/live-insert.mjsscript8.9 KB
scripts/live-manual-edit-evidence.mjsscript11.4 KB
scripts/live-poll.mjsscript13.2 KB
scripts/live-resume.mjsscript4.4 KB
scripts/live-server.mjsscript41.5 KB
scripts/live-status.mjsscript2.1 KB
scripts/live-wrap.mjsscript35.1 KB
scripts/live.mjsscript8.3 KB
scripts/live/browser-script-parts.mjsscript1.7 KB
scripts/live/completion.mjsscript969 B
scripts/live/event-validation.mjsscript6.2 KB
scripts/live/insert-ui.mjsscript15.3 KB
scripts/live/manual-apply.mjsscript34.1 KB
scripts/live/manual-edit-routes.mjsscript14.6 KB
scripts/live/manual-edits-buffer.mjsscript5.0 KB
scripts/live/session-store.mjsscript10.4 KB
scripts/live/svelte-component.mjsscript27.2 KB
scripts/live/sveltekit-adapter.mjsscript9.1 KB
scripts/live/ui-core.mjsscript5.4 KB
scripts/live/vocabulary.mjsscript3.2 KB
scripts/modern-screenshot.umd.jsscript28.6 KB
scripts/palette.mjsscript56.9 KB
scripts/pin.mjsscript6.0 KB

scripts/lib/is-generated.mjs

View on GitHub
/**
 * Decide whether a given file is "generated" (regenerated by a build step,
 * unsafe to write variants into) or "source" (safe to edit, changes persist).
 *
 * Why this matters: when the user picks an element on a page whose underlying
 * file is regenerated by a build step (e.g. `scripts/build-sub-pages.js`
 * rewriting `public/docs/*.html`), writing variants or accepted changes into
 * that file is silent data loss — the next build wipes them.
 *
 * Signals, in order of reliability:
 *   1. Git check-ignore: gitignored files are assumed generated.
 *   2. File-header markers ("GENERATED", "DO NOT EDIT", "AUTO-GENERATED")
 *      within the first ~300 characters — catches non-git projects.
 */

import { execSync } from 'node:child_process';
import fs from 'node:fs';
import path from 'node:path';

const HEADER_SCAN_BYTES = 300;
const HEADER_MARKERS = [
  /@generated\b/i,
  /\bGENERATED\s+FILE\b/,
  /\bAUTO-?GENERATED\b/i,
  /\bDO\s+NOT\s+EDIT\b/i,
];

/**
 * @param {string} filePath - absolute or cwd-relative path
 * @param {object} [options]
 * @param {string} [options.cwd] - project root (defaults to process.cwd())
 */
export function isGeneratedFile(filePath, options = {}) {
  const cwd = options.cwd || process.cwd();
  const absPath = path.isAbsolute(filePath) ? filePath : path.resolve(cwd, filePath);

  if (isGitIgnored(absPath, cwd)) return true;
  if (hasGeneratedHeader(absPath)) return true;
  return false;
}

function isGitIgnored(absPath, cwd) {
  try {
    execSync(`git check-ignore --quiet ${JSON.stringify(absPath)}`, {
      cwd,
      stdio: 'ignore',
    });
    return true; // exit 0 = ignored
  } catch (err) {
    // Exit code 1 = not ignored. Exit code 128 = not a git repo or other error.
    // In both cases, treat as "not known to be ignored."
    return false;
  }
}

function hasGeneratedHeader(absPath) {
  let fd;
  try {
    fd = fs.openSync(absPath, 'r');
    const buf = Buffer.alloc(HEADER_SCAN_BYTES);
    const bytesRead = fs.readSync(fd, buf, 0, HEADER_SCAN_BYTES, 0);
    const head = buf.slice(0, bytesRead).toString('utf-8');
    return HEADER_MARKERS.some((re) => re.test(head));
  } catch {
    return false;
  } finally {
    if (fd !== undefined) { try { fs.closeSync(fd); } catch {} }
  }
}
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: 472kUpdated 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: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated 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