How do I install the Kiss Arch Extraction skill?

Run npx skillmds@latest add dauquangthanh/kiss-arch-extraction in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Kiss Arch Extraction safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Kiss Arch Extraction?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Kiss Arch Extraction free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Kiss Arch Extraction?

dauquangthanh (@dauquangthanh) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Kiss Arch Extraction by dauquangthanh

Name: Kiss Arch Extraction
Author: dauquangthanh

Kiss Arch Extraction

Extracts architecture from an existing codebase — containers, components, data flow, external dependencies. Produces an architecture doc that can seed new ADRs and C4 diagrams. Use when reverse-engineering a codebase, onboarding to a new project, or when architecture documentation needs to be generated from existing code.

dauquangthanh Updated Sep 17, 2026

File contents

User Input

$ARGUMENTS

Audience and tone (interactive mode)

When KISS_AGENT_MODE=interactive (the default), assume the user has limited technical background and limited domain knowledge — they may know basics but lack deep expertise in this skill's area. Run this skill as a guided questionnaire:

One question at a time. No walls of questions.
Yes / no first. Phrase so yes, no, not sure, or skip is a valid answer.
Translate jargon, don't strip it. Use the technical term but always pair it with a plain-English gloss the first time it appears.
Choices, not blank fields. When yes/no isn't enough, offer 2-4 lettered options (A/B/C/D) with one-line plain-language descriptions of the trade-off. Always include "Not sure — pick a sensible default".
Always recommend. State the option you would pick and why in one sentence so the user can reply "yes" / "ok" to accept. Pull defaults from upstream artefacts (spec, architecture, ADRs, standards) before asking blank.
Show, don't ask. When upstream artefacts already imply an answer, propose it as a pre-filled finding and ask for a yes / no confirmation rather than asking the user to fill in a blank.
not sure / skip triggers a sensible default, marked "(default applied — confirm later)" in the artefact, and a debt entry in this skill's debt file.

When KISS_AGENT_MODE=auto (or --auto), skip the questionnaire entirely: apply sensible defaults from upstream artefacts and log decisions to the parent agent's decision log.

Inputs

.kiss/context.yml
{context.paths.docs}/analysis/codebase-scan.md
Source tree

Outputs

{context.paths.docs}/architecture/extracted.md
{context.paths.docs}/architecture/extracted.extract

Context Update

Does not mutate .kiss/context.yml.

Handoffs

kiss-c4-diagrams converts extracted structure into C4 Mermaid.
kiss-adr seeds candidate ADRs for decisions embedded in the code (e.g. "chose PostgreSQL") that had no prior ADR.

AI authoring scope

Does: read config files (compose / k8s / terraform / ci), entry-point modules, and infer the container + dependency graph. Flag decisions that appear to have been made implicitly (no ADR).

Does not: modify code; claim intent without evidence.

Usage

<SKILL_DIR> = the integration's skills root (e.g. .claude/skills/ for Claude Code, .agents/skills/ for Antigravity / Codex, .cursor/skills/ for Cursor, .windsurf/workflows/ for Windsurf). Scripts live at <SKILL_DIR>/<skill-name>/scripts/….

bash <SKILL_DIR>/kiss-arch-extraction/scripts/bash/extract.sh --auto

---name: kiss-arch-extractiondescription: Extracts architecture from an existing codebase — containers, components, data flow, external dependencies. Produces an architecture doc that can seed new ADRs and C4 diagrams. Use when reverse-engineering a codebase, onboarding to a new project, or when architecture documentation needs to be generated from existing code.---## User Input```text$ARGUMENTS```## Audience and tone (interactive mode)When `KISS_AGENT_MODE=interactive` (the default), assume the userhas **limited technical background and limited domain knowledge**— they may know basics but lack deep expertise in this skill'sarea. Run this skill as a guided questionnaire:- **One question at a time.** No walls of questions.- **Yes / no first.** Phrase so `yes`, `no`, `not sure`, or `skip` is a valid answer.- **Translate jargon, don't strip it.** Use the technical term but always pair it with a plain-English gloss the first time it appears.- **Choices, not blank fields.** When yes/no isn't enough, offer 2-4 lettered options (A/B/C/D) with one-line plain-language descriptions of the trade-off. Always include "Not sure — pick a sensible default".- **Always recommend.** State the option you would pick and why in one sentence so the user can reply "yes" / "ok" to accept. Pull defaults from upstream artefacts (spec, architecture, ADRs, standards) before asking blank.- **Show, don't ask.** When upstream artefacts already imply an answer, propose it as a pre-filled finding and ask for a yes / no confirmation rather than asking the user to fill in a blank.- **`not sure` / `skip` triggers a sensible default**, marked "(default applied — confirm later)" in the artefact, and a debt entry in this skill's debt file.When `KISS_AGENT_MODE=auto` (or `--auto`), skip the questionnaireentirely: apply sensible defaults from upstream artefacts and logdecisions to the parent agent's decision log.## Inputs- `.kiss/context.yml`- `{context.paths.docs}/analysis/codebase-scan.md`- Source tree## Outputs- `{context.paths.docs}/architecture/extracted.md`- `{context.paths.docs}/architecture/extracted.extract`## Context UpdateDoes not mutate `.kiss/context.yml`.## Handoffs- `kiss-c4-diagrams` converts extracted structure into C4 Mermaid.- `kiss-adr` seeds candidate ADRs for decisions embedded in the code (e.g. "chose PostgreSQL") that had no prior ADR.## AI authoring scope**Does:** read config files (compose / k8s / terraform / ci),entry-point modules, and infer the container + dependency graph.Flag decisions that appear to have been made implicitly (no ADR).**Does not:** modify code; claim intent without evidence.## Usage> `<SKILL_DIR>` = the integration's skills root (e.g. `.claude/skills/`> for Claude Code, `.agents/skills/` for Antigravity / Codex,> `.cursor/skills/` for Cursor, `.windsurf/workflows/` for Windsurf).> Scripts live at `<SKILL_DIR>/<skill-name>/scripts/…`.```bashbash <SKILL_DIR>/kiss-arch-extraction/scripts/bash/extract.sh --auto```

Frequently asked questions