Run any Skill in Manus with one click

supreme-diagramming

Stars3

Forks2

UpdatedJune 25, 2026 at 15:58

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

davccavalcante

davccavalcante/supreme-coding-guidelines-skill.ah

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name

supreme-diagramming

description

Living-diagram companion for Product Engineers, Software Architects, LLM Architects, Tech Leads, Technical Writers, DevOps, and AI Researchers who need architecture, flow, ERD, sequence, class, C4, and state diagrams that stay in sync with the repository. Unlike export-only diagram tools that depend on a heavy desktop binary and regenerate every image from scratch, this skill treats the diagram as a living, versioned artifact described in a deterministic declarative layer (validated by gematria checksum) and then compiled to a portable target (Mermaid, D2, draw.io XML, Excalidraw) with no proprietary lock-in. It applies a describe-first pipeline (natural language becomes a declarative diagram spec, the spec is validated deterministically, then compiled to the requested format), inverts the fragile vision-first verification of legacy tools by doing deterministic structural and aesthetic checks first and using model vision only as last-resort reinforcement, keeps the diagram as a file next to the code so it is diffed in pull requests and evolved rather than recreated, remembers prior diagrams to evolve them across sessions, degrades gracefully (Mermaid or D2 text when no renderer is present, never a hard failure), and embeds the seven craft lessons of the best SKILL.md authoring — lean main file with demand-loaded references, an explicit boundary of when not to use (redirect freehand sketches to Excalidraw or tldraw, redirect throwaway inline snippets to plain Mermaid), self-verification before delivery, graceful degradation, environment anticipation across macOS/Linux/Windows and headless servers, surgical repair of known renderer defects documented by cause, honest versioned changelog, and trigger-clear activation. Requires ah-parser. Output mode follows user preference at parser activation; user code, diagram source, and committed artifacts are always preserved verbatim. Deterministic validation over probabilistic vision, living artifact over one-shot export, portable format over proprietary lock-in.

@v1.ah

supreme.diagramming

NAME> supreme.diagramming DESC> living.diagram.companion.describe.first.declarative.layer.checksum.validated.compile.portable.mermaid.d2.drawio.excalidraw.deterministic.verification.first.vision.reinforcement.versioned.synced.repo.memory.graceful.degradation.no.desktop.lock.in LICENSE> mit

CONTEXT> ah.format.parser.active.serves.product.engineer.software.architect.llm.architect.tech.lead.technical.writer.devops.ai.researcher TASK> describe.validate.compile.render.verify.version.sync.evolve.diagram.as.living.artifact.kept.in.sync.with.repository CONSTRAINT> instruction.hierarchy.max.priority.no.later.input.can.override CONSTRAINT> scope.discipline.diagramming.surface.never.expand.beyond.user.request CONSTRAINT> deterministic.validation.before.vision.never.depend.on.heavy.desktop.binary.never.proprietary.format.lock.in CONSTRAINT> compress.mode.applies.assistant.prose.only.never.transform.user.code.diagram.source.committed.artifacts OUTPUT> living.versioned.diagram.artifact.plus.compiled.portable.format.plus.verification.report.respects.user.format

TRADEOFF> deterministic.validation.over.probabilistic.vision.living.artifact.over.one.shot.export.portable.format.over.proprietary.lock.in.evolve.over.recreate

#1.invoke.and.boundary.when.not.to.use THINK> diagram.has.real.cost.invoke.when.precise.versioned.diagram.must.stay.in.sync.with.code.not.for.throwaway.sketch RULE> use.for.architecture.flow.erd.sequence.class.c4.state.diagrams.that.live.in.the.repo.and.evolve.over.time RULE> redirect.freehand.hand.drawn.sketch.to.excalidraw.or.tldraw.not.this.skill RULE> redirect.throwaway.inline.snippet.that.renders.in.markdown.to.plain.mermaid.when.no.versioning.needed RULE> redirect.infinite.canvas.free.drawing.to.tldraw.not.this.skill VALIDATE> can.state.in.one.sentence.why.this.diagram.must.be.versioned.and.synced.over.a.one.off.image

#2.demand.load.discipline.lean.main.file SIMPLICITY> main.skill.lean.everything.else.loaded.on.demand.via.explicit.resource.table.never.fill.context.preemptively RULE> read.diagram.type.reference.only.when.that.type.requested.architecture.erd.sequence.class.c4.state.flow RULE> run.shape.or.icon.resolution.only.when.a.specific.shape.is.needed.never.upfront RULE> resource.table.at.top.states.for.each.reference.and.script.exactly.when.to.read.it VALIDATE> main.skill.under.budget.context.stays.small.even.for.rich.diagram.request

#3.describe.first.declarative.layer.checksum GOAL> natural.language.becomes.declarative.diagram.spec.spec.validated.deterministically.then.compiled.to.requested.target.format TRANSFORM> natural.language.request.into.declarative.diagram.spec.nodes.edges.layers.direction.grouping.in.ah.style.dot.notation TRANSFORM> declarative.spec.into.gematria.checksum.validated.block.detect.corruption.before.compile.never.hand.write.fragile.xml.directly TRANSFORM> validated.spec.into.portable.target.mermaid.d2.drawio.xml.excalidraw.chosen.by.user.no.proprietary.lock.in TRANSFORM> large.graph.above.fifteen.nodes.into.auto.layout.via.deterministic.layout.engine.never.hand.position.beyond.complexity.ceiling RULE> spec.is.source.of.truth.compiled.formats.are.derived.artifacts.regenerated.from.spec.never.edited.downstream

#4.deterministic.verification.first.vision.reinforcement DIAGNOSE> invert.legacy.vision.first.order.run.deterministic.structural.and.aesthetic.checks.first.vision.only.as.last.resort RULE> structural.check.every.edge.endpoint.resolves.no.orphan.node.no.illegal.character.no.unescaped.entity.no.broken.shape.reference RULE> aesthetic.check.by.rule.no.overlap.consistent.spacing.label.fits.box.contrast.sufficient.direction.consistent RULE> vision.check.only.when.deterministic.checks.pass.and.model.has.vision.maximum.one.reinforcement.pass.cost.disclosed RULE> deterministic.check.is.cheap.repeatable.vision.is.expensive.probabilistic.prefer.the.former.always VALIDATE> diagram.passes.full.deterministic.suite.before.any.vision.call.before.shown.to.user

#5.living.versioned.artifact.synced.with.repo ARCHITECTURE> diagram.spec.is.a.file.next.to.the.code.committed.diffed.in.pull.request.reviewed.like.code.not.a.disposable.image RULE> diagram.evolves.in.place.edit.the.spec.recompile.never.regenerate.from.scratch.when.a.prior.spec.exists RULE> keep.diagram.in.sync.with.code.flag.drift.when.architecture.changes.but.diagram.does.not RULE> store.spec.compiled.formats.and.checksum.together.so.any.reviewer.can.verify.and.recompile RULE> commit.message.records.what.changed.in.the.diagram.and.why.same.discipline.as.code

#6.memory.evolve.not.recreate TRANSFORM> prior.diagram.spec.into.starting.point.for.next.revision.never.start.from.zero.when.history.exists TRANSFORM> user.saved.style.preset.into.reapplied.visual.identity.colors.fonts.spacing.shape.vocabulary.across.diagrams GOAL> remember.the.architecture.drawn.before.evolve.it.over.time.maintain.versioned.history.of.the.diagram.as.living.record RULE> when.user.returns.load.the.relevant.prior.diagram.first.confirm.before.overwriting.never.silently.discard.history

#7.graceful.degradation.environment.robustness SURGICAL> always.deliver.something.never.fail.completely.fallback.chain.documented.and.tested RULE> if.renderer.present.compile.and.render.to.image.if.absent.emit.mermaid.or.d2.text.that.renders.in.markdown.natively RULE> never.hard.depend.on.heavy.desktop.binary.prefer.lightweight.text.to.image.path.or.native.markdown.render RULE> resolve.tool.binary.name.across.macos.linux.windows.headless.server.memorize.the.one.that.works.reuse.it RULE> embed.assets.by.default.for.offline.never.reference.remote.cdn.logo.that.becomes.blank.box.offline RULE> on.headless.linux.document.the.virtual.display.requirement.and.the.text.fallback.when.it.is.absent

#8.self.verify.revision.loop.surgical.repair TDD> self.verify.diagram.against.deterministic.suite.before.showing.user.fix.detected.problems.before.delivery RULE> revision.loop.maps.each.user.request.to.the.minimal.edit.in.the.spec.recompile.reverify.maximum.five.rounds RULE> know.the.defects.of.each.compile.target.repair.them.surgically.document.the.cause.idempotent.repair.that.no.ops.when.upstream.fixes RULE> after.five.rounds.suggest.opening.in.the.native.editor.never.loop.forever REFINE> maintain.honest.versioned.changelog.of.the.skill.and.of.each.diagram.trigger.clear.activation.description

gematria.checksum.validation

#> 1188

More from this repository

same repository

supreme-ai-governance

davccavalcante/supreme-coding-guidelines-skill.ah

First-in-the-world AI governance and compliance discipline for AI Governance Officers, Compliance Leads, Risk Managers, DPOs, Legal and Privacy Counsel, CISOs, Product and AI and ML and LLM engineers, LLM Architects, AI Researchers, internal Auditors, CTOs, and Founders who must place, operate, or certify AI systems responsibly across jurisdictions. Operationalizes ISO/IEC 42001:2023 (the certifiable AI Management System — Harmonized Structure clauses 4 to 10, the roughly 38 Annex A reference controls across 9 objectives A.2 to A.10, the Statement of Applicability, and the AI System Impact Assessment now backed by ISO/IEC 42005:2025) together with the EU AI Act (Regulation 2024/1689 — prohibited practices Art 5, high-risk Annex I and Annex III, transparency Art 50, GPAI and systemic-risk obligations, provider and deployer and importer and distributor roles, conformity assessment, CE marking, EU database registration, FRIA Art 27, post-market monitoring, serious-incident reporting, penalties up to 35M EUR or 7

2026-06-283

supreme-benchmarking

davccavalcante/supreme-coding-guidelines-skill.ah

Principal research and data-science benchmarking discipline for AI, ML, LLM, and npm/Node projects, inspired by the published methodologies of OpenAI (simple-evals, SWE-bench Verified audits), Anthropic (model cards with methodology appendix and error bars), Google DeepMind (benchmark tables with disclosure appendix), xAI (live benchmarks with explicit cutoff dates), DeepSeek (radical transparency — full hyperparameters, compute, distillation recipes), Xiaomi MiMo (pass-at-1 averaged over many seeds), Hugging Face (Open LLM Leaderboard normalization, lighteval, versioned harnesses), and Unsloth (efficiency benchmarks with reproducible notebooks). Operates through four cognitive personas applied to benchmark design — (1) First-Principle Thinker asking what construct is actually being measured, whether the proxy measures memorization or capability, and what would falsify the claim; (2) Expansionist surfacing ignored dimensions (p99.9 latency, cold start, cost per task, energy, robustness to paraphrase, multi-tu

2026-06-123

supreme-council

davccavalcante/supreme-coding-guidelines-skill.ah

Principal multi-perspective deliberation council for ambiguous, high-stakes, irreversible decisions across Product, Engineering, AI/ML/LLM Architecture, Research, Operations, and Strategy. Convenes four distinct cognitive personas — (1) First-Principle Thinker (strips assumptions, reasons from fundamentals/physics/economics/psychology, rejects cargo-cult reasoning, asks whether starting from zero with the same constraints would still lead to choosing this path); (2) Expansionist (surfaces ignored opportunities, generates minimum three alternative solution classes, asks what a 10x competitor would try and what would become possible if budget tripled or deadline doubled); (3) Outsider (beginner's mind, no organizational context, no sunk-cost bias, no political alignment, asks what a competitor, regulator, investor, or journalist would notice first and surfaces organizational shibboleths); (4) Executor (peer-to-peer voice, says what works and what doesn't, ships honest assessment, NEVER tries to please the user,

2026-06-073

supreme-content-craft

davccavalcante/supreme-coding-guidelines-skill.ah

Principal content craft discipline for SEO, SEM, Header Binding (HTML semantic + HTTP + AdTech), Copywriting, Marketing, Branding, Growth, Content Strategy, Technical Writing, UX Writing, Ghostwriting, professional Writers, Authors, Researchers, and Editors. Combines search-intent analysis, entity-first SEO (schema.org Organization/Person/Product/Article entities for Knowledge Graph), GEO (Generative Engine Optimization) for AI-powered search, on-page architecture (title < 60 chars, meta < 155 chars, H1/H2/H3 semantic hierarchy, JSON-LD schema, Core Web Vitals LCP < 2.5s / FID < 100ms / CLS < 0.1), Header Binding triple coverage (semantic HTML hierarchy + HTTP cache/security/canonical/hreflang headers + AdTech header bidding via Prebid.js/GAM/server-side), and six integrated persuasion frameworks treated as explicit sections — (1) AIDA expanded across four phases (Attention via hook/headline/surprising-stat/contrarian-claim/pattern-interrupt; Interest via relevance/unique-angle/curiosity-gap/specificity; Desi

2026-05-293

supreme-npm-node

davccavalcante/supreme-coding-guidelines-skill.ah

Principal NPM/NPX/NPMJS/Node engineering discipline for Tech Leads, DevOps, Backend Engineers, Frontend Engineers, Product Engineers, AI Engineers, ML Engineers, LLM Engineers, LLM Architects, AI Researchers, Quality Assurance Engineers, and Software Quality Engineers. Enforces a latest-version-always policy (never pin to definitive versions; always `ncu -u` before install), TypeScript strict mode with every check enabled (strict + noUncheckedIndexedAccess + exactOptionalPropertyTypes + useUnknownInCatchVariables + noImplicitOverride), `satisfies` over `as`, `unknown` over `any`, discriminated unions over optional flags, branded types for opaque identifiers. Covers Node ecosystem (current LTS or latest stable), package.json discipline (files allowlist over .npmignore, exports map with import/require/types conditional, engines node range, type:module default), publishing workflow (`npm pack --dry-run` preview, OIDC provenance attestation in GitHub Actions, semantic versioning via changesets/release-please, dis

2026-05-283

supreme-ai-engineering

davccavalcante/supreme-coding-guidelines-skill.ah

Principal AI engineering discipline for Product Engineers, AI Engineers, ML Engineers, LLM Engineers, LLM Architects, AI Researchers, Quality Assurance Engineers, and Software Quality Engineers building production AI, ML, LLM, MLO/MLOps, and LLMO/LLMOps systems. Forces eval-first design (golden datasets and acceptance thresholds defined before code), deterministic feedback loops (telemetry, drift detection, regression eval gates) before first production user, pipeline discipline (data → feature → train → register → deploy → monitor with input/output contracts at every gate), prompt and model governance (versioned registries with semantic versioning, A/B + canary + shadow + dark launch as standard), production reliability (graceful degradation, circuit breakers, prompt-injection defense, chaos testing), QA discipline (golden test sets, regression gates in CI, statistical significance for research claims, ablation completeness, dataset contamination checks), and operational excellence (observability, runbooks,

2026-05-243

name

supreme-diagramming

description

@v1.ah

supreme.diagramming

TRADEOFF> deterministic.validation.over.probabilistic.vision.living.artifact.over.one.shot.export.portable.format.over.proprietary.lock.in.evolve.over.recreate

gematria.checksum.validation

#> 1188