Acong Layout Demo

该 Skill 以多文件渐进披露方式演示复杂目录结构，包含扁平参考文档、references/ 深层文档、scripts/ 下的 shell 与 Python 本地脚本，以及 assets/ 模板与配置示例，并提示按需读取或运行校验脚本；它本身不执行业务处理，主要用于编写或验证 Skill 布局。

yarnovo

热度 43.77

最近更新 2026-05-11 17:44:36

分类：开发依赖：代码执行 / 读写文件应用场景：模板 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add acong-layout-demo

Metadata

name: acong-layout-demo
description: Kitchen-sink SKILL.md demonstrating the full recommended skill directory layout — multi-file progressive disclosure (FORMS.md + REFERENCE.md), a `references/` subfolder with deep docs, a `scripts/` subfolder with executable helpers, and an `assets/` subfolder with templates. Use when you need a reference implementation for authoring complex Claude Code / ClawHub skills, or when validating a skill loader's ability to handle nested directories.

Acong Layout Demo

A reference skill that exercises every structural convention published by Anthropic + the openclaw / vercel-labs community. Use it as a template when bootstrapping non-trivial skills.

When to use

Authoring a new complex skill and looking for a layout blueprint
Validating a skill loader / registry / CLI handles nested folders
Teaching Progressive Disclosure (Level 1/2/3) by example

Progressive Disclosure levels demonstrated

Level	File	Purpose
1 — metadata (always loaded)	`SKILL.md` frontmatter	`name` + `description`
2 — instructions (on trigger)	`SKILL.md` body (this text)	Overview + when-to-use
3 — references (on demand)	`FORMS.md`, `REFERENCE.md` (flat) + `references/*.md` (nested)	Deep docs, loaded only when needed
3 — scripts (on demand)	`scripts/.sh`, `scripts/.py`	Deterministic helpers executed via bash
3 — assets (on demand)	`assets/*`	Templates, schemas, fixtures

Structure map

acong-layout-demo/
├── SKILL.md              ← you are here
├── FORMS.md              ← flat-style reference (Anthropic doc example)
├── REFERENCE.md          ← flat-style API ref
├── references/
│   ├── api-guide.md
│   └── examples.md
├── scripts/
│   ├── hello.sh          ← shell helper
│   └── validate.py       ← python helper
└── assets/
    ├── template.md.tpl   ← text template
    └── config.example.yaml

Usage hints for Claude

Need a quick answer? Stay in this file (Level 2).
Need to fill a form? Read FORMS.md.
Need API spec? Read REFERENCE.md or references/api-guide.md for extended version.
Need deterministic validation? Run scripts/validate.py <file>.
Need a template? Copy assets/template.md.tpl and substitute placeholders.

Not functional

This skill doesn't do anything — it's a structural demo. Copy its layout when starting a real skill.