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/class/README.md

View on GitHub
# Class and Interface Renderer

Render `diagram_type: "class"` JSON files into the standard Archify HTML template.

```bash
node archify/renderers/class/render-class.mjs input.class.json output.html
```

The renderer validates input against `archify/schemas/class.schema.json` with the
bundled standalone validator. No dependency installation is required. If
`output.html` is omitted, it uses `meta.output` or falls back to `class.html` in
the current working directory. `--layout-json` prints the placed types and
routes instead of writing HTML.

## Input

```json
{
  "schema_version": 1,
  "diagram_type": "class",
  "meta": { "title": "Payment module types" },
  "types": [],
  "relationships": [],
  "cards": []
}
```

A type carries its name in `label`, its `kind`, a `row`/`col` grid cell (or an
absolute `pos`), and optional `sublabel`, `attributes`, `methods`, and `sources`.
Authors choose the members the explanation needs; a type may show none.

| `kind` | Header | Colour family |
| --- | --- | --- |
| `class` | name only | backend |
| `abstract` | `«abstract»`, italic name | backend |
| `interface` | `«interface»` | frontend |
| `enum` | `«enumeration»`; `attributes` are the constants | messagebus |
| `record` | `«record»` | database |

An attribute is `{ name, type?, visibility?, static? }` and draws as
`+ name: Type`. A method is `{ name, parameters?, returns?, visibility?,
static?, abstract? }` and draws as `+ name(parameters): Returns`. Visibility
uses the UML glyphs `+` public, `#` protected, `~` package, `-` private; a
static member is underlined and an abstract method is italic. Interface
attributes describe property contracts (for example, TypeScript's
`interface Person { name: string }`); they do not imply stored implementation
state. Interfaces may also declare static constants.

## Relationships

Every relationship reads `from` -> `to`, and `kind` owns the whole notation, so
an implementation can never look like a call arrow:

| `kind` | Meaning | Line | Marker |
| --- | --- | --- | --- |
| `dependency` | `from` uses `to` | dashed | open arrow at `to` |
| `association` | `from` holds a reference to `to` | solid | open arrow at `to` |
| `inheritance` | `from` extends `to` | solid | hollow triangle at `to` |
| `realization` | `from` implements interface `to` | dashed | hollow triangle at `to` |
| `composition` | `from` owns `to` and its lifetime | solid | filled diamond at `from` |
| `aggregation` | `from` groups `to` without owning it | solid | hollow diamond at `from` |

Semantic checks: a realization runs from a non-interface to an interface
(`class/realization-target`); inheritance never crosses the interface boundary
(`class/inheritance-kind`); inheritance cannot form a cycle
(`class/inheritance-cycle`); a relationship cannot connect a type to itself.

## Layout

`layout.mode: "grid"` (the default) places types by `row`/`col` on the banded
grid shared with the ERD renderer: each column takes its widest type and each
row its tallest. Types are centred in their row band so a relationship between
two types of one row is a straight line. A half-step `col` (e.g. `1.5`) centres
a type between two columns without sizing either, which is how a supertype sits
symmetrically over two subtypes; it occupies both neighbouring cells. `layout.gapX`/`gapY` (default 128/84)
leave room for markers and labels; `layout.typeW` (180) is the minimum and
`layout.typeMaxW` (300) the maximum automatic width.

Members are never truncated. A type without `width` grows to its widest member
up to `typeMaxW`; longer members wrap. A wrapped method is set like formatter
output: `name(` ends the first line, parameters hang one step deeper (breaking
after commas), and `): Return` closes it. Visibility glyphs and type
annotations are set in the muted ink so member names carry the row. An authored `width` is
authoritative, and only a title that does not fit it is an error
(`class/title-text-capacity`).

Generalizations are routed vertically whenever the two types are not side by
side, so supertypes stand above their subtypes. Two or more automatic
generalizations of one kind into one supertype, from subtypes placed below it
with at least 40px of gap, draw as one hierarchy bus: a single triangle and
trunk, a horizontal bus halfway down the gap, and a drop to each subtype. The
bus is drawn from the supertype outward so a dashed realization bus keeps one
dash phase. Its `data-motion-path` carries the source-to-target route so Viewer
tokens and flow overlays follow the relationship's semantic direction. A bus
that would cross another type falls back to ordinary routes.

主干还会与完整场景中的其他关系共同检查:同一个主干组可以共享端口和线段。
主干候选若与其他组或普通关系争用标记空间、重叠走廊或形成内部交叉,
整组关系回退到现有路由器,以独立端口和走廊重新规划;无冲突的
其他主干保留。每轮回退后重新检查剩余主干,且只删除冲突组,不反复恢复尝试。
类型位置、关系种类和方向、显式 `via`、端口、路由及标签位置保持作者的控制。
此检查决定是否保留自动主干,不承诺固定路线周围满足全部自动间距或任意布局都能成功。
固定路线之间的冲突和无法绕开的复杂交叉仍遵循现有路由约束,不会修改作者指定的几何。

All other relationships use the shared orthogonal router
(`../architecture/routing.mjs`) and the shared Clean Flow, crossing, corridor,
rhythm, and label-clearance gates.

Labels sit on the segment with the most room: above a horizontal run, beside a
vertical one. `labelAt`, `labelDx`/`labelDy`, and `labelSegment` override it.

`via: []` 与省略 `via` 等价,在主干选择和回退路由前统一按无路径点处理。
非空 `via` 仍是显式几何;其他路由与标签控制不变,原始 JSON 不会被改写。

## Reader and export

An automatic canvas declares `data-reader-fit="intrinsic-height"` and a 7.5px
reader text floor, like the ERD, so a tall model scrolls instead of shrinking
members past legibility. The legend lists the relationship kinds present, drawn
in their own notation; hovering or focusing an entry dims the other kinds. Every
type is a focusable node whose passport shows its kind and `sublabel`; supplied
`sources` appear as repository evidence. The notation lives in the SVG's own
`<style>` and markers, so SVG/PNG export keeps it.

## Tested size

`examples/payment-processors.class.json` (11 types, 10 relationships, long
signatures) renders in about 0.2s and passes the showcase gates at a 7.5px
projected text minimum in a 1440px desktop reader. Wider models need more rows
rather than more columns to stay above that floor.
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