Skip to content

Codebase Analysis β€” DocKit Master

Quick Reference

  • Project: DocKit Master
  • Type: AI Skill Engine / Static Landing Site
  • Languages: Markdown (skills), Bash (CLI), HTML/CSS/JS (landing pages)
  • Frameworks: Astro Starlight (docs output)
  • Files: ~96 (excluding node_modules, dist)
  • Lines of Code: ~12,000+
graph TB

    subgraph Core["Knowledge Engine"]
        SKILL["Skills - 11 files\nAnalysis, Personas, JTBD\nFlows, Tech, SOP, API\nSEO, Content, LLM"]
        WORKFLOW["Workflows - 5 files\nExport Markdown\nSetup Astro\nGenerate Sitemap"]
    end

    subgraph Integration["Multi-IDE Integration"]
        ADAPTERS["Adapters - 6 IDEs\nCursor, Claude, Gemini\nOpenCode, Windsurf, AGENTS"]
        SCRIPTS["Scripts\ndockit-master.sh\ninstall.sh"]
    end

    subgraph Presentation["Landing Site"]
        PAGES["Pages\nHome, Features, Use Cases\nClaw Platforms"]
    end

    subgraph Output["Generated Output"]
        OUTPUT["docs/ Markdown\nastro-site/ Starlight"]
    end

    SKILL --> WORKFLOW
    WORKFLOW --> OUTPUT
    SCRIPTS --> SKILL
    ADAPTERS --> SKILL

Architecture summary: DocKit Master is a skill-based AI documentation engine. The core consists of 11 Markdown skill files that instruct AI agents to analyze codebases and generate structured documentation. Workflows orchestrate the export process. Scripts provide CLI interaction, and adapters enable cross-IDE compatibility.

DocKit Master/
β”œβ”€β”€ SKILL.md # Main orchestrator (295 lines)
β”œβ”€β”€ README.md # Project overview
β”œβ”€β”€ index.html # Landing page (59K)
β”œβ”€β”€ skills/ # 11 skill files β€” core engine
β”‚ β”œβ”€β”€ analyze-codebase.md
β”‚ β”œβ”€β”€ persona-builder.md
β”‚ β”œβ”€β”€ jtbd-analyzer.md
β”‚ β”œβ”€β”€ flow-mapper.md
β”‚ β”œβ”€β”€ tech-docs.md
β”‚ β”œβ”€β”€ sop-guide.md
β”‚ β”œβ”€β”€ api-reference.md
β”‚ β”œβ”€β”€ content-guidelines.md
β”‚ β”œβ”€β”€ content-writing.md
β”‚ β”œβ”€β”€ llm-optimization.md
β”‚ └── seo-checklist.md
β”œβ”€β”€ workflows/ # 5 workflow files
β”‚ β”œβ”€β”€ export-markdown.md
β”‚ β”œβ”€β”€ setup-astro.md
β”‚ β”œβ”€β”€ generate-sitemap.md
β”‚ β”œβ”€β”€ generate-docs.md
β”‚ └── setup-docusaurus.md
β”œβ”€β”€ scripts/ # 2 CLI scripts
β”‚ β”œβ”€β”€ dockit-master.sh
β”‚ └── install.sh
β”œβ”€β”€ adapters/ # 6 IDE adapters
β”‚ β”œβ”€β”€ cursor.mdc
β”‚ β”œβ”€β”€ claude.md
β”‚ β”œβ”€β”€ gemini.md
β”‚ β”œβ”€β”€ opencode.md
β”‚ β”œβ”€β”€ windsurf.md
β”‚ └── agents.md
β”œβ”€β”€ templates/ # 3 template sets
β”‚ β”œβ”€β”€ astro-premium/
β”‚ β”œβ”€β”€ docusaurus-premium/
β”‚ └── markdown/
β”œβ”€β”€ pages/ # Landing site sub-pages
β”‚ β”œβ”€β”€ features/
β”‚ β”œβ”€β”€ use-cases/
β”‚ β”œβ”€β”€ claw/
β”‚ β”œβ”€β”€ css/
β”‚ └── js/
β”œβ”€β”€ docs/ # Generated documentation (this)
└── astro-site/ # Generated Astro Starlight site
ComponentDescriptionKey Files
Skill Engine11 instruction files guiding AI agentsskills/*.md
OrchestratorMain entry point routing to skillsSKILL.md
CLIInteractive Bash prompt generatorscripts/dockit-master.sh
InstallerMulti-IDE installerscripts/install.sh
IDE AdaptersEntry points for 6 AI IDEsadapters/*
Astro TemplatePremium Starlight configtemplates/astro-premium/
Landing SiteMulti-page showcase (vi/en/zh/ja)index.html, pages/
sequenceDiagram
    autonumber
    actor User
    participant CLI as CLI / IDE
    participant SK as SKILL.md
    participant AN as Analyze
    participant KN as Knowledge
    participant TD as Tech Docs
    participant SP as SOP
    participant AP as API Ref
    participant EX as Export

    User->>CLI: Run dockit-master.sh
    CLI->>SK: Config params
    SK->>AN: Scan codebase
    AN-->>SK: analysis.md
    SK->>KN: Personas + JTBD + Flows
    KN-->>SK: personas/ jtbd/ flows/
    SK->>TD: Architecture + DB + Deploy
    TD-->>SK: tech docs
    SK->>SP: User Guides
    SP-->>SK: sop/
    SK->>AP: Endpoint Reference
    AP-->>SK: api/
    SK->>EX: Astro or Markdown
    EX-->>User: Final site

Pipeline summary: User triggers the CLI, SKILL.md orchestrates: Analyze β†’ Knowledge β†’ Tech β†’ SOP β†’ API β†’ Export. Each step reads previous output and enriches it.

FileRoleSize
SKILL.mdMain orchestrator13.2 KB
skills/flow-mapper.md4 flow type generator11.5 KB
skills/persona-builder.mdBuyer & User Personas8.6 KB
skills/content-guidelines.mdContent structure rules8.5 KB
scripts/install.shMulti-IDE installer8.5 KB
scripts/dockit-master.shInteractive CLI7.7 KB
index.htmlLanding page59.4 KB
#DecisionRationaleStatus
1Markdown-based skillsPortable, IDE-agnostic, version-controllableAccepted
2Astro Starlight over Docusaurus50MB vs 1.5GB, auto-sidebar, native MarkdownAccepted
3Knowledge layer firstPersonas + JTBD + Flows enrich all downstream docsAccepted
4Multi-IDE adaptersLightweight references to SKILL.md, no duplicationAccepted
5SEO + LLM dual optimizationEvery page serves both search engines and AIAccepted