Skip to content

amanpal3/Dr-SKILLs / .agent/skills/archify

archify

Unverified

Create validated architecture, workflow, sequence, data-flow, lifecycle/state, ERD, class, tree, timeline, and waterfall diagrams as explorable standalone HTML with dark/light themes, motion and image/SVG/WebM export. Accept requirements or Mermaid; inspect repository evidence for code-backed diagrams. Use when visualizing systems, API calls, pipelines, schemas, histories, timings, or everyday steps, parts, relationships and states. Also turn an answer into a one-page explainer, with the conclusion first, structured panels, native diagrams and charts, when the user asks for a page, an explainer or an answer to share (做成一页, 用页面讲), or proactively when the user's rules opt in with an [archify explainer: ...] line. Not for dashboards.

FileKindSize
LICENSEother11.1 KB
LICENSE-MITother1.1 KB
NOTICEother1.3 KB
SKILL.mdskill md18.4 KB
THIRD_PARTY_NOTICES.mdmarkdown5.5 KB
assets/JetBrainsMono-OFL.txtmarkdown4.3 KB
assets/template.htmlother768.9 KB
bin/archify.mjsscript282.0 KB
bin/delivery-update.mjsscript3.6 KB
bin/finalize.mjsscript48.9 KB
bin/open-artifact.mjsscript4.0 KB
bin/preview.mjsscript35.8 KB
bin/recover-output.mjsscript1.3 KB
bin/visual-check.mjsscript117.7 KB
brand-marks/README.mdmarkdown1.4 KB
brand-marks/catalog.jsonconfig13.8 KB
delta/architecture-delta.mjsscript77.2 KB
examples/agent-run.lifecycle.jsonconfig3.2 KB
examples/agent-tool-call.workflow.jsonconfig4.8 KB
examples/archify-dev-activity.timeline.jsonconfig4.4 KB
examples/archify-repository.tree.jsonconfig4.3 KB
examples/async-job-roundtrip.sequence.jsonconfig3.7 KB
examples/brand-aware-delivery.architecture.jsonconfig2.7 KB
examples/cache-miss-request.sequence.jsonconfig3.7 KB
examples/checkout-platform.base.architecture.jsonconfig2.2 KB
examples/checkout-platform.head.architecture.jsonconfig2.4 KB
examples/checkout-request.waterfall.jsonconfig1.2 KB
examples/class-payment-processors-rendered.htmlother854.5 KB
examples/class-payments-rendered.htmlother821.1 KB
examples/dataflow-product-analytics.htmlother824.1 KB
examples/delivery.explainer.jsonconfig4.5 KB
examples/deployment-release.lifecycle.jsonconfig4.1 KB
examples/erd-orders-rendered.htmlother841.1 KB
examples/event-stream.dataflow.jsonconfig4.7 KB
examples/example-rebuild.waterfall.jsonconfig4.5 KB
examples/holiday-planning.workflow.jsonconfig2.9 KB
examples/incident-response.workflow.jsonconfig4.6 KB
examples/lifecycle-agent-run.htmlother827.8 KB
examples/locales/de.jsonconfig27.8 KB
examples/locales/fr.jsonconfig28.6 KB
examples/locales/fr.partial.jsonconfig959 B
examples/locales/it.jsonconfig28.1 KB
examples/locales/ja.jsonconfig31.7 KB
examples/locales/pt.jsonconfig27.8 KB
examples/locales/ru.jsonconfig36.1 KB
examples/orders.erd.jsonconfig7.1 KB
examples/payment-incident.timeline.jsonconfig1.4 KB
examples/payment-platform.tree.jsonconfig1.2 KB
examples/payment-processors.class.jsonconfig7.1 KB
examples/payments.class.jsonconfig2.8 KB
examples/product-analytics.dataflow.jsonconfig4.9 KB
examples/production-deployment.architecture.jsonconfig4.6 KB
examples/release-delivery.workflow.jsonconfig4.4 KB
examples/sequence-cache-miss-request.htmlother821.8 KB
examples/subscription-billing-rendered.htmlother863.5 KB
examples/subscription-billing.erd.jsonconfig11.5 KB
examples/timeline-archify-dev-activity-rendered.htmlother846.2 KB
examples/timeline-payment-incident-rendered.htmlother814.5 KB
examples/tree-archify-repository-rendered.htmlother856.8 KB
examples/tree-payment-platform-rendered.htmlother820.0 KB
examples/waterfall-checkout-request-rendered.htmlother813.9 KB
examples/waterfall-example-rebuild-rendered.htmlother843.0 KB
examples/web-app-rendered.htmlother826.4 KB
examples/web-app.architecture.jsonconfig3.1 KB
examples/workflow-agent-tool-call-rendered.htmlother831.3 KB
explainer/browser-check.mjsscript30.0 KB
explainer/charts.mjsscript5.9 KB
explainer/check.mjsscript14.5 KB
explainer/diagrams.mjsscript37.8 KB
explainer/diff.mjsscript8.3 KB
explainer/inline.mjsscript8.5 KB
explainer/layout.mjsscript2.5 KB
explainer/page-bundle.mjsscript1.1 KB
explainer/parse.mjsscript26.6 KB
explainer/patch.mjsscript11.8 KB
explainer/prepare.mjsscript9.6 KB
explainer/reader.cssother46.1 KB
explainer/reader.jsscript50.5 KB
explainer/render.mjsscript33.2 KB
explainer/revision.mjsscript1.9 KB
explainer/sources.mjsscript20.4 KB
explainer/validate.mjsscript14.2 KB
explainer/writing.mjsscript11.1 KB
locales/README.mdmarkdown2.2 KB
locales/ar.jsonconfig33.0 KB
locales/en.jsonconfig26.7 KB
locales/es.jsonconfig28.8 KB
locales/ko.jsonconfig30.1 KB
locales/manifest.jsonconfig293 B
locales/zh-CN.jsonconfig26.4 KB
locales/zh-TW.jsonconfig26.5 KB
migrations/workflow-v2.mjsscript9.0 KB
package.jsonmanifest400 B
recipes/scenarios.mjsscript40.5 KB
references/architecture-layout-repair.mdmarkdown4.3 KB
references/authoring-contract.mdmarkdown41.7 KB
references/authoring-defaults.mdmarkdown12.6 KB
references/brand-marks.mdmarkdown5.6 KB
references/delivery-contract.mdmarkdown48.7 KB
references/explainer-authoring.mdmarkdown18.5 KB
references/repository-authoring.mdmarkdown7.8 KB
references/update-awareness.mdmarkdown1.9 KB
references/viewer-runtime.mdmarkdown5.6 KB
renderers/architecture/grid.mjsscript2.0 KB
renderers/architecture/labels.mjsscript155 B
renderers/architecture/render-architecture.mjsscript57.2 KB
renderers/architecture/routing.mjsscript72.7 KB
renderers/class/README.mdmarkdown6.6 KB
renderers/class/render-class.mjsscript52.3 KB
renderers/dataflow/README.mdmarkdown9.0 KB
renderers/dataflow/dataflow-compiler.mjsscript89.1 KB
renderers/dataflow/joint-label-routing.mjsscript10.6 KB
renderers/dataflow/label-capacity.mjsscript4.3 KB
renderers/dataflow/render-dataflow.mjsscript960 B
renderers/erd/README.mdmarkdown14.2 KB
renderers/erd/grid.mjsscript6.9 KB
renderers/erd/render-erd.mjsscript78.6 KB
renderers/explainer/render-explainer.mjsscript3.2 KB
renderers/lifecycle/README.mdmarkdown6.0 KB
renderers/lifecycle/render-lifecycle.mjsscript59.9 KB
renderers/sequence/README.mdmarkdown8.5 KB
renderers/sequence/render-sequence.mjsscript55.8 KB
renderers/shared/atomic-output.mjsscript68.7 KB
renderers/shared/automatic-labels.mjsscript14.4 KB
renderers/shared/brand-marks.mjsscript28.3 KB
renderers/shared/cli.mjsscript18.6 KB
renderers/shared/desktop-readability.mjsscript6.8 KB
renderers/shared/diagnostics.mjsbinary8.1 KB
renderers/shared/engineering-profiles.mjsscript6.8 KB
renderers/shared/generated-brand-marks.mjsscript159.8 KB
renderers/shared/generated-validators.mjsscript996.1 KB
renderers/shared/geometry.mjsscript87.8 KB
renderers/shared/i18n.mjsscript13.5 KB
renderers/shared/layout-report.mjsscript1.5 KB
renderers/shared/legend.mjsscript9.0 KB
renderers/shared/node-card-style.mjsscript2.4 KB
renderers/shared/output-path.mjsscript18.6 KB
renderers/shared/owned-temp-directory.mjsscript3.1 KB
renderers/shared/path-semantics.mjsscript31.6 KB
renderers/shared/portable-path.mjsscript12.2 KB
renderers/shared/repository-evidence.mjsscript19.9 KB
renderers/shared/repository-location.mjsscript4.2 KB
renderers/shared/route-quality.mjsscript26.3 KB
renderers/shared/sidecar-path.mjsscript1.2 KB
renderers/shared/software-notices.mjsscript506 B
renderers/shared/spatial-grid.mjsscript2.4 KB
renderers/shared/svg-path-analysis.mjsscript5.3 KB
renderers/shared/text-fit.mjsscript5.1 KB
renderers/shared/utils.mjsscript12.7 KB
renderers/shared/validator.mjsscript3.3 KB
renderers/timeline/README.mdmarkdown4.0 KB
renderers/timeline/render-timeline.mjsscript29.6 KB
renderers/tree/README.mdmarkdown4.2 KB
renderers/tree/render-tree.mjsscript29.9 KB
renderers/waterfall/README.mdmarkdown3.4 KB
renderers/waterfall/render-waterfall.mjsscript22.5 KB
renderers/workflow/README.mdmarkdown17.3 KB
renderers/workflow/render-workflow.mjsscript1.6 KB
renderers/workflow/workflow-compiler.mjsscript244.3 KB
renderers/workflow/workflow-migration-geometry.mjsscript6.2 KB
renderers/workflow/workflow-placement-repair.mjsscript4.7 KB
schemas/README.mdmarkdown14.7 KB
schemas/architecture.schema.jsonconfig5.9 KB
schemas/class.schema.jsonconfig7.9 KB
schemas/common.schema.jsonconfig5.6 KB
schemas/dataflow.schema.jsonconfig6.2 KB
schemas/erd.schema.jsonconfig9.1 KB
schemas/explainer.schema.jsonconfig18.8 KB
schemas/lifecycle.schema.jsonconfig5.2 KB
schemas/sequence.schema.jsonconfig6.0 KB
schemas/timeline.schema.jsonconfig3.9 KB
schemas/tree.schema.jsonconfig3.1 KB
schemas/waterfall.schema.jsonconfig3.4 KB
schemas/workflow.schema.jsonconfig9.9 KB
scripts/check-render-output.mjsscript66.9 KB
scripts/check-update.mjsscript57.9 KB
scripts/delivery-update-child.mjsscript1.3 KB
scripts/render-examples.mjsscript2.0 KB
scripts/update-contract.mjsscript6.7 KB
skill-release.jsonconfig260 B

renderers/erd/grid.mjs

View on GitHub
/** Banded grid placement for the ER IR. Not auto-layout: column widths and row
 *  band heights are measured from the boxes the author declares, so the same
 *  spec always produces the same coordinates. */

export const DEFAULT_ER_GRID = {
  mode: 'grid',
  // The top origin leaves room for a domain caption above the first band, and
  // the left origin starts the first column inside the page margin so the
  // canvas is not edge-to-edge. Row bands are taller than the generic rhythm
  // because a table row is text a reader has to scan, not a node label.
  origin: [32, 40],
  gapX: 56,
  gapY: 44,
  // Wide enough for a long field name plus its SQL type at the legibility
  // sizes below (a 20-character name and a numeric(12,2) type).
  entityW: 240,
  // Header and row bands are sized for the field type legibility the reader
  // asked for: an 11-unit field name and a 10.5-unit type sit on a 20-unit
  // row, and the table name leads them on a 30-unit header.
  headerH: 30,
  rowH: 20,
};

export function erGridLayout(er) {
  const raw = er.layout;
  // Grid cells without a layout block mean the default grid, not absolute
  // coordinates that were never supplied.
  if (!raw) {
    const gridPlaced = (er.entities || []).some((entity) => Number.isFinite(entity?.row) && Number.isFinite(entity?.col));
    return gridPlaced ? { ...DEFAULT_ER_GRID } : null;
  }
  if (raw.mode !== 'grid') return null;
  return { ...DEFAULT_ER_GRID, ...raw };
}

// An entity may omit `width` and inherit the grid's default. Both the layout and
// the placement validator must resolve that the same way: reading `entity.width`
// directly turned the documented default into NaN and reported a placement
// failure for a box the schema accepts.
export function resolvedEntityWidth(entity, grid) {
  return Number.isFinite(entity?.width) ? entity.width : (grid?.entityW ?? DEFAULT_ER_GRID.entityW);
}

// One header band plus one band per declared column. An entity with no columns
// still needs a readable body, so the minimum is a single row.
export function entityHeight(entity, grid) {
  const rows = Math.max(1, Array.isArray(entity.attributes) ? entity.attributes.length : 0);
  return grid.headerH + rows * grid.rowH + 6;
}

// Every raw column index owns the widest box placed in it and every raw row
// index owns the tallest, so boxes in one band share a baseline without anyone
// measuring by hand. Indices with no box still contribute their gap, which is
// how an author asks for a routing channel between two bands. A box on a half
// column (a class grid's `col: 1.5`) is centred between two columns: it sizes
// its row but neither column.
const gridColumn = (col) => Number.isInteger(col * 2) && col >= 0;
// `columnGaps` raises the gap after a column to a measured floor (see the
// renderer's relationship-label demand); the authored or default gapX stays
// the minimum everywhere, so an absent map reproduces the plain grid.
export function bandedLayout(entities, grid, { columnGaps = null } = {}) {
  const widths = new Map();
  const heights = new Map();
  let maxCol = -1;
  for (const entity of entities) {
    if (!Number.isInteger(entity.row) || !gridColumn(entity.col)) continue;
    maxCol = Math.max(maxCol, Math.ceil(entity.col));
    if (Number.isInteger(entity.col)) widths.set(entity.col, Math.max(widths.get(entity.col) || 0, resolvedEntityWidth(entity, grid)));
    heights.set(entity.row, Math.max(heights.get(entity.row) || 0, entity.height));
  }

  const columnX = new Map();
  const rowY = new Map();
  let x = grid.origin[0];
  for (let col = 0; col <= maxCol; col += 1) {
    columnX.set(col, x);
    x += (widths.get(col) || 0) + Math.max(grid.gapX, columnGaps?.get(col) || 0);
  }
  // A half-column box may be wider than its empty neighbouring bands. Keep
  // every grid box inside the left margin without changing integer-only grids.
  let leftInset = 0;
  for (const entity of entities) {
    if (!Number.isInteger(entity.row) || !gridColumn(entity.col) || Number.isInteger(entity.col)) continue;
    const centre = (col) => columnX.get(col) + (widths.get(col) || 0) / 2;
    const midpoint = (centre(Math.floor(entity.col)) + centre(Math.ceil(entity.col))) / 2;
    leftInset = Math.max(leftInset, grid.origin[0] - midpoint + resolvedEntityWidth(entity, grid) / 2);
  }
  if (leftInset > 0) {
    for (const [col, column] of columnX) columnX.set(col, column + leftInset);
    x += leftInset;
  }
  let y = grid.origin[1];
  const maxRow = Math.max(-1, ...heights.keys());
  for (let row = 0; row <= maxRow; row += 1) {
    rowY.set(row, y);
    y += (heights.get(row) || 0) + grid.gapY;
  }

  return { columnX, rowY, widths, heights, totalWidth: x, totalHeight: y };
}

export function resolveEntityPos(entity, grid, bands) {
  if (Array.isArray(entity.pos) && entity.pos.length === 2) return entity.pos;
  if (!grid || !bands) return [NaN, NaN];
  if (!Number.isInteger(entity.row) || !gridColumn(entity.col)) return [NaN, NaN];
  const width = resolvedEntityWidth(entity, grid);
  const rowY = bands.rowY.get(entity.row);
  if (!Number.isInteger(entity.col)) {
    const centre = (col) => bands.columnX.get(col) + (bands.widths.get(col) || 0) / 2;
    const [left, right] = [Math.floor(entity.col), Math.ceil(entity.col)];
    if (![bands.columnX.get(left), bands.columnX.get(right), rowY].every(Number.isFinite)) return [NaN, NaN];
    return [(centre(left) + centre(right)) / 2 - width / 2, rowY];
  }
  const columnX = bands.columnX.get(entity.col);
  if (!Number.isFinite(columnX) || !Number.isFinite(rowY)) return [NaN, NaN];
  // Centre each box in its column so the gaps on both sides stay equal; the
  // router reads those gaps as corridors.
  const columnWidth = bands.widths.get(entity.col) || width;
  return [columnX + (columnWidth - width) / 2, rowY];
}

export function validateErGridPlacement(er, grid, bands, problems) {
  const seen = new Map();
  for (const entity of er.entities ?? []) {
    const hasPos = Array.isArray(entity.pos) && entity.pos.length === 2;
    if (!hasPos && !grid) {
      problems.push(`Entity "${entity.id}" needs pos [x,y] or a grid layout with row/col.`);
      continue;
    }
    if (hasPos) continue;
    if (!Number.isInteger(entity.row) || !Number.isInteger(entity.col)) {
      problems.push(`Entity "${entity.id}" needs pos [x,y] or grid row/col when layout.mode is "grid".`);
      continue;
    }
    if (entity.row < 0 || entity.col < 0) {
      problems.push(`Entity "${entity.id}" row/col must be non-negative integers.`);
      continue;
    }
    const key = `${entity.row},${entity.col}`;
    if (seen.has(key)) {
      problems.push(`Entities "${seen.get(key)}" and "${entity.id}" share grid cell row ${entity.row} col ${entity.col}.`);
    } else {
      seen.set(key, entity.id);
    }
    const [x, y] = resolveEntityPos(entity, grid, bands);
    if (!Number.isFinite(x) || !Number.isFinite(y)) {
      problems.push(`Entity "${entity.id}" could not be placed from row ${entity.row} col ${entity.col}.`);
    }
  }
}
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