Skip to content

ShipfoxHQ/shipfox / .github/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 md10.4 KB
reference/adapt.mdmarkdown10.1 KB
reference/adapt.native.mdmarkdown3.8 KB
reference/android.mdmarkdown3.2 KB
reference/animate.mdmarkdown4.7 KB
reference/audit.mdmarkdown7.7 KB
reference/audit.native.mdmarkdown8.2 KB
reference/bolder.mdmarkdown3.1 KB
reference/clarify.mdmarkdown4.5 KB
reference/colorize.mdmarkdown4.4 KB
reference/craft-floor.mdmarkdown3.7 KB
reference/craft.mdmarkdown555 B
reference/critique.mdmarkdown39.0 KB
reference/delight.mdmarkdown3.6 KB
reference/distill.mdmarkdown5.5 KB
reference/doctor.mdmarkdown4.6 KB
reference/document.mdmarkdown26.8 KB
reference/extract.mdmarkdown3.3 KB
reference/harden.mdmarkdown8.3 KB
reference/hooks.mdmarkdown11.6 KB
reference/init.mdmarkdown8.6 KB
reference/ios.mdmarkdown2.9 KB
reference/layout.mdmarkdown5.0 KB
reference/live-setup.mdmarkdown7.2 KB
reference/live.mdmarkdown34.8 KB
reference/new-work.mdmarkdown27.2 KB
reference/onboard.mdmarkdown7.6 KB
reference/operate.mdmarkdown4.0 KB
reference/optimize.mdmarkdown7.4 KB
reference/overdrive.mdmarkdown8.6 KB
reference/polish.mdmarkdown5.1 KB
reference/quieter.mdmarkdown4.7 KB
reference/routing.mdmarkdown2.8 KB
reference/shape.mdmarkdown3.5 KB
reference/typeset.mdmarkdown5.1 KB
reference/visualize.mdmarkdown10.2 KB
scripts/command-metadata.jsonconfig7.7 KB
scripts/concept-seed.mjsscript27.0 KB
scripts/context-signals.mjsscript14.0 KB
scripts/context.mjsscript58.4 KB
scripts/critique-storage.mjsscript7.9 KB
scripts/detect-csp.mjsscript6.6 KB
scripts/detect.mjsscript620 B
scripts/detector/browser/injected/index.mjsscript79.6 KB
scripts/detector/cli/main.mjsscript18.8 KB
scripts/detector/design-system.mjsscript34.3 KB
scripts/detector/detect-antipatterns-browser.jsscript358.1 KB
scripts/detector/detect-antipatterns.mjsscript1.8 KB
scripts/detector/engines/browser/detect-url.mjsscript14.1 KB
scripts/detector/engines/regex/detect-text.mjsscript34.5 KB
scripts/detector/engines/static-html/css-cascade.mjsscript42.7 KB
scripts/detector/engines/static-html/detect-html.mjsscript11.7 KB
scripts/detector/engines/visual/screenshot-contrast.mjsscript6.4 KB
scripts/detector/findings.mjsscript766 B
scripts/detector/node/file-system.mjsscript7.6 KB
scripts/detector/profile/profiler.mjsscript4.4 KB
scripts/detector/registry/antipatterns.mjsscript27.2 KB
scripts/detector/rules/checks.mjsscript246.3 KB
scripts/detector/shared/color.mjsscript4.4 KB
scripts/detector/shared/constants.mjsscript4.6 KB
scripts/detector/shared/fonts.mjsscript852 B
scripts/detector/shared/inline-ignores.mjsscript6.0 KB
scripts/detector/shared/page.mjsscript252 B
scripts/doctor.mjsscript11.6 KB
scripts/embed-prompt.mjsscript5.8 KB
scripts/generate-image.mjsscript9.6 KB
scripts/hook-admin.mjsscript28.4 KB
scripts/hook-before-edit.mjsscript18.3 KB
scripts/hook-lib.mjsscript81.4 KB
scripts/hook.mjsscript2.6 KB
scripts/lib/artifact-schema.mjsscript3.8 KB
scripts/lib/composition-catalog.mjsscript10.0 KB
scripts/lib/concept-catalog.mjsscript17.4 KB
scripts/lib/design-parser.mjsscript25.2 KB
scripts/lib/impeccable-config.mjsscript22.2 KB
scripts/lib/impeccable-paths.mjsscript4.9 KB
scripts/lib/is-generated.mjsscript2.2 KB
scripts/lib/provider.mjsscript327 B
scripts/lib/roll-selection.mjsscript16.9 KB
scripts/lib/staleness-deep.mjsscript19.6 KB
scripts/lib/staleness-notice.mjsscript6.5 KB
scripts/lib/staleness.mjsscript19.0 KB
scripts/lib/surface-briefs.mjsscript6.1 KB
scripts/lib/target-args.mjsscript1.1 KB
scripts/lib/target-slug.mjsscript1.0 KB
scripts/lib/template-extensions.mjsscript5.3 KB
scripts/live-accept.mjsscript35.5 KB
scripts/live-browser-dom.jsscript4.2 KB
scripts/live-browser-session.jsscript3.2 KB
scripts/live-browser.jsscript489.1 KB
scripts/live-commit-manual-edits.mjsscript41.2 KB
scripts/live-complete.mjsscript4.7 KB
scripts/live-copy-edit-agent.mjsscript28.2 KB
scripts/live-discard-manual-edits.mjsscript1.6 KB
scripts/live-inject.mjsscript18.1 KB
scripts/live-insert.mjsscript9.8 KB
scripts/live-manual-edit-evidence.mjsscript11.6 KB
scripts/live-poll.mjsscript15.7 KB
scripts/live-resume.mjsscript6.0 KB
scripts/live-server.mjsscript66.1 KB
scripts/live-status.mjsscript2.6 KB
scripts/live-target.mjsscript934 B
scripts/live-wrap.mjsscript38.2 KB
scripts/live.mjsscript13.1 KB
scripts/live/accept-css.mjsscript22.0 KB
scripts/live/accept-verify.mjsscript2.7 KB
scripts/live/browser-script-parts.mjsscript2.1 KB
scripts/live/completion.mjsscript1.4 KB
scripts/live/event-validation.mjsscript9.4 KB
scripts/live/frameworks/astro.mjsscript1.7 KB
scripts/live/frameworks/detect-utils.mjsscript2.1 KB
scripts/live/frameworks/index.mjsscript5.7 KB
scripts/live/frameworks/journal.mjsscript7.0 KB
scripts/live/frameworks/nextjs.mjsscript1.7 KB
scripts/live/frameworks/nuxt.mjsscript5.1 KB
scripts/live/frameworks/script-src.mjsscript699 B
scripts/live/frameworks/static-html.mjsscript656 B
scripts/live/frameworks/sveltekit.mjsscript1.8 KB
scripts/live/frameworks/tag-strategy.mjsscript10.6 KB
scripts/live/frameworks/tanstack-start.mjsscript1.6 KB
scripts/live/frameworks/vite-generic.mjsscript1.3 KB
scripts/live/generation-preflight.mjsscript5.8 KB
scripts/live/insert-ui.mjsscript15.3 KB
scripts/live/instructions.mjsscript12.9 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/poll-lanes.mjsscript759 B
scripts/live/roots.mjsscript20.4 KB
scripts/live/session-store.mjsscript22.4 KB
scripts/live/source-lock.mjsscript3.6 KB
scripts/live/source-search.mjsscript4.2 KB
scripts/live/svelte-ast.mjsscript37.7 KB
scripts/live/svelte-component.mjsscript49.6 KB
scripts/live/sveltekit-adapter.mjsscript11.1 KB
scripts/live/tanstack-adapter.mjsscript9.5 KB
scripts/live/ui-core.mjsscript5.4 KB
scripts/live/vocabulary.mjsscript7.0 KB
scripts/modern-screenshot.umd.jsscript28.6 KB
scripts/palette.mjsscript55.5 KB
scripts/pin.mjsscript6.3 KB
scripts/serve-question.mjsscript60.2 KB
scripts/surface-brief.mjsscript2.5 KB

scripts/live/frameworks/index.mjs

View on GitHub
/**
 * The live-mode framework registry.
 *
 * Before this existed, framework knowledge was smeared across live-inject.mjs
 * (detection order, the Nuxt adapter, the Astro `is:inline` branch), the two
 * adapter modules, and live-wrap.mjs (which extension gets component preview,
 * which gets Astro's global-prefixed CSS, which gets JSX comments). Adding or
 * fixing a framework meant reading all of them.
 *
 * One entry per framework now declares everything the live scripts need:
 *
 *   name        stable identifier; also the `adapter` value in inject JSON.
 *   detect      (cwd, config) → falsy when this is not the project, otherwise
 *               a truthy project descriptor that apply/remove/artifacts read.
 *               Order in FRAMEWORKS is priority order; first truthy wins.
 *   inject      { kind: 'adapter', apply, remove, ignorePatterns, artifacts,
 *               unpatch } for frameworks that server-render their document
 *               shell, or { kind: 'tag' } for the generic marker-wrapped
 *               <script src> block.
 *   source      how live-wrap treats files this framework authors:
 *               extensions, preview ('source' | 'component'), styleMode,
 *               styleTag, commentSyntax, injectScriptAttrs. Anything omitted
 *               falls back to SOURCE_TRAIT_DEFAULTS.
 *
 * Two rules hold the thing together:
 *
 * 1. **Detection order is injection priority.** SvelteKit → Nuxt → TanStack
 *    Start → Astro → Next → Vite → static HTML, exactly the order
 *    live-inject.mjs used to hard-code. static-html always matches, so
 *    resolveFramework never returns null.
 * 2. **Source traits resolve by file extension, not by project.** A SvelteKit
 *    project's injection target is `src/app.html`; a Vite app can contain
 *    `.astro` partials. live-wrap has always keyed these off the target file,
 *    and resolveSourceTraits keeps it that way. Several entries may claim the
 *    same extension (`.tsx` belongs to three); when they do, the values must
 *    agree, which tests/live-frameworks.test.mjs asserts.
 */

import path from 'node:path';

import { sveltekit } from './sveltekit.mjs';
import { nuxt } from './nuxt.mjs';
import { tanstackStart } from './tanstack-start.mjs';
import { astro } from './astro.mjs';
import { nextjs } from './nextjs.mjs';
import { viteGeneric } from './vite-generic.mjs';
import { staticHtml } from './static-html.mjs';
import { TAG_PATCH_MARKERS, unpatchTagFile } from './tag-strategy.mjs';

/** Priority order. Do not reorder without re-reading rule 1 above. */
export const FRAMEWORKS = Object.freeze([
  sveltekit,
  nuxt,
  tanstackStart,
  astro,
  nextjs,
  viteGeneric,
  staticHtml,
]);

export const PREVIEW_MODES = Object.freeze(['source', 'component']);
export const STYLE_MODES = Object.freeze(['scoped', 'astro-global-prefixed']);
export const COMMENT_SYNTAXES = Object.freeze(['html', 'jsx']);
export const INJECT_KINDS = Object.freeze(['adapter', 'tag']);

export const SOURCE_TRAIT_DEFAULTS = Object.freeze({
  preview: 'source',
  styleMode: 'scoped',
  styleTag: '<style data-impeccable-css="SESSION_ID">',
  commentSyntax: 'html',
  injectScriptAttrs: '',
});

/** The patch kind the generic tag strategy records in the journal. */
export const TAG_PATCH_KIND = 'live-tag';

/**
 * Undo functions keyed by the `patch` value an artifact carries. Built from
 * the entries so a new adapter registers its own undo alongside its apply.
 */
export const PATCH_UNDOERS = Object.freeze(Object.assign(
  { [TAG_PATCH_KIND]: unpatchTagFile },
  ...FRAMEWORKS.map((framework) => framework.inject.unpatch || {}),
));

/**
 * First entry whose detect() matches. Returns { framework, project } where
 * project is the detector's descriptor (adapters read it; tag frameworks
 * mostly ignore it).
 */
export function resolveFramework(cwd = process.cwd(), config = null) {
  for (const framework of FRAMEWORKS) {
    const project = framework.detect(cwd, config);
    if (project) return { framework, project };
  }
  // Unreachable while static-html stays terminal, but a caller that reorders
  // the array should get a diagnosable null rather than a silent tag inject.
  return null;
}

/**
 * Source-authoring traits for one file, merged over SOURCE_TRAIT_DEFAULTS.
 * `framework` names the entry that claimed the extension, or null.
 */
export function resolveSourceTraits(filePath) {
  const ext = path.extname(String(filePath || '')).toLowerCase();
  for (const framework of FRAMEWORKS) {
    const source = framework.source;
    if (!source || !source.extensions.includes(ext)) continue;
    const { extensions, ...traits } = source;
    return { framework: framework.name, ...SOURCE_TRAIT_DEFAULTS, ...traits };
  }
  return { framework: null, ...SOURCE_TRAIT_DEFAULTS };
}

/**
 * Extra gitignore patterns the resolved framework needs beyond the static
 * LIVE_IGNORE_PATTERNS list (paths that depend on a detected srcDir or file
 * extension and so cannot be written down ahead of time).
 */
export function frameworkIgnorePatterns(resolved) {
  const fn = resolved?.framework?.inject?.ignorePatterns;
  return typeof fn === 'function' ? (fn(resolved.project) || []) : [];
}

/**
 * The files this injection will create or patch, in journal-artifact form.
 * Adapters declare their own; the tag strategy patches exactly the resolved
 * config files.
 */
export function describeInjectArtifacts(resolved, { cwd = process.cwd(), files = [] } = {}) {
  if (!resolved) return [];
  const { framework, project } = resolved;
  if (framework.inject.kind === 'adapter') {
    return (framework.inject.artifacts?.({ cwd, project }) || []).filter((a) => a && a.path);
  }
  return files.map((file) => ({
    kind: 'patched',
    path: file,
    patch: TAG_PATCH_KIND,
    markers: [...TAG_PATCH_MARKERS],
  }));
}
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