violet: Skill for Claude Code

.agents/skills/module-scaffolding/SKILL.md

module-scaffolding is a skill for Claude Code, Codex from VOD-Studio/violet. It costs 58 tokens per session (773 once invoked), scanned A, original, MIT.

A guide for adding a backend module or frontend feature to a codebase divided into domain, application, infrastructure, and interface layers. DDD, or domain-driven design, is a way to organise code around the business concepts it represents.

In plain words
What is it for?
Scaffolding backend entities, services, repositories, HTTP handlers, dependency-injection containers, routes, and database migrations, plus frontend feature folders and data hooks.
Why use it?
It prevents new features from missing required files, dependency wiring, database migrations, or route registration.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: installed under .agents/ (shared by several agents).

This is VOD-Studio/violet's own configuration. It tells Claude Code and Codex how to work on violet itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything violet configures →

Reuse

Borrowing it

Nothing to install: this file belongs to VOD-Studio/violet. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/VOD-Studio/violet/release/2.0/.agents/skills/module-scaffolding/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/VOD-Studio/violet

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for module-scaffolding

README.md
[![agentmods](https://agentmods.dev/badge/skills/vod-studio/violet/module-scaffolding/github.svg)](https://agentmods.dev/skills/vod-studio/violet/module-scaffolding)
Your own site
<a href="https://agentmods.dev/skills/vod-studio/violet/module-scaffolding"><img src="https://agentmods.dev/badge/skills/vod-studio/violet/module-scaffolding/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for module-scaffolding

Your own site · 80×15
<a href="https://agentmods.dev/skills/vod-studio/violet/module-scaffolding"><img src="https://agentmods.dev/badge/skills/vod-studio/violet/module-scaffolding.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 58 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 773 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00058 $0.00773
Opus 5.5 $0.00023 $0.00309
Sonnet 5.5 $0.00012 $0.00155
Haiku 4.5 $0.00006 $0.00077

Measured 2mo ago against content hash 72ddad60eb1a, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

module-scaffolding scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- 后端:编译通过 + 新端点路由可达(起服务 curl 或看路由表测试);有仓储实现必有对应接口在 domain。
.agents/skills/module-scaffolding/SKILL.md · 51 lines

What it actually says

新增模块装配手册

适用于 DDD 分层仓库(domain / application / infrastructure / interfaces)。以仓库里最近新增的一个同类模块为模板——它的 commit 就是装配清单的活样本(git log --diff-filter=A --name-only -- <domain 目录> 可列出全部落点)。

后端模块七处落点

按依赖顺序创建,每处一行职责:

# 层 职责 探测方式
1 domain/<mod>/ 实体、值对象、仓储接口 看最近模块的 entity/repository 文件对
2 application/<mod>/ 用例编排 service;跨层依赖的端口接口 ports.go 可选,无跨层依赖不建
3 infrastructure 持久层 仓储实现 + PO 模型(ORM 映射) 与 domain 仓储接口成对
4 interfaces HTTP handler 请求/响应 DTO 与 HTTP 适配 一个 <mod>.go 起步
5 DI 容器文件 模块级 *Container,构造函数装配 1-4 手工 DI 仓库必有;wire 仓库则改 provider set
6 根容器挂载 容器聚合 struct 加字段 + 构造两行 grep 根容器文件找最近模块的挂载行照抄
7 路由注册 路由依赖 struct 加 handler 字段 + 子路由注册 公开路由与 admin 路由分开注册;admin 侧挂权限中间件

配套:数据库迁移 {NNN}_{slug}.{up,down}.sql 成对,NNN 取当前最大值 +1。

前端 feature 骨架

features/<name>/
  api/client.ts      # 端点函数,收/发散请求响应类型
  api/queries.ts     # TanStack Query hooks(useQuery/useMutation)
  api/keys.ts        # query key 工厂
  model/types.ts     # 命名 interface 的 DTO 与领域类型
  ui/                # 组件(Feature 私有,通用件待第二消费方出现再上提)

路由页是薄壳:取数 + 组装 feature 组件。admin 页接入见 admin-data-table(若该项目有对应 skill)。

完成判据

  • 后端:编译通过 + 新端点路由可达(起服务 curl 或看路由表测试);有仓储实现必有对应接口在 domain。
  • 前端:typecheck 通过 + 页面渲染真实数据。
  • 文档:按仓库文档责任地图(若有)同步模块清单。

反指标

  • domain 引用 infrastructure/application(依赖方向反了)。
  • handler 里写业务分支(该下沉 application)。
  • repository 返回 DTO(该留在 interfaces 层转换)。
  • 新建全局工具函数而最近的模块里已有同款(先 grep 再写)。
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2mo ago First seen · 51 lines · 58 tokens per session scan A 72ddad60eb1a

Subscribe to this mod's changes

module-scaffolding is a skill published in the GitHub repository VOD-Studio/violet (4 stars, last pushed yesterday), licensed MIT. It adds 58 tokens to every session and 773 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

module-scaffolding compared with skills from other repositories

module-scaffolding next to 6 skills from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
module-scaffoldingVOD-Studio/violetSkill4yesterdayMITA58Claude Code, Codex
ddd-go-backendLSTM-Kirigaya/jinhui-skillsSkill242mo agononeA98Claude Code, Codex
build-teaql-appteaql/teaql-agent-kitSkill2.8kyesterdayMITA112Codex
design-mcp-servercyanheads/obsidian-mcp-serverSkill7026d agoApache-2.0A62Claude Code
api-telemetrycyanheads/obsidian-mcp-serverSkill7026d agoApache-2.0A85Claude Code
api-servicescyanheads/obsidian-mcp-serverSkill7026d agoApache-2.0A32Claude Code
api-gatewayTheBeardedBearSAS/claude-craftSkill1073d agoMITA43Claude Code