← 返回 Skills 市场

Acong Layout Demo

Name: Acong Layout Demo
Author: yarnovo

作者 yarnb · GitHub ↗ · v0.1.0 · MIT-0

cross-platform ✓ 安全检测通过

124

总下载

当前安装

版本数

在 OpenClaw 中安装

/install acong-layout-demo

功能描述

Kitchen-sink SKILL.md demonstrating the full recommended skill directory layout — multi-file progressive disclosure (FORMS.md + REFERENCE.md), a `references/...

使用说明 (SKILL.md)

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 \x3Cfile>.
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.

安全使用建议

This repository is a harmless layout/demo. The only executable helpers are scripts/hello.sh (prints a greeting) and scripts/validate.py (checks a file exists and is non-empty; it does not print file contents or reach the network). If you allow an agent to run Level 3 scripts, be mindful that an agent could be instructed to invoke those scripts with arbitrary filesystem paths — validate.py only reports existence/size, but avoid passing sensitive file paths to any automated agent unless you trust it and the runtime environment.

功能分析

Type: OpenClaw Skill Name: acong-layout-demo Version: 0.1.0 The skill is a structural reference template designed to demonstrate directory layout and progressive disclosure conventions for OpenClaw agents. It contains no functional logic beyond a simple greeting script (scripts/hello.sh) and a basic file existence validator (scripts/validate.py), both of which are safe and transparent. No indicators of malicious intent, data exfiltration, or prompt injection were found.

能力评估

✓ Purpose & Capability

The name/description (layout demo) matches the files and behavior: documentation, example assets, and small deterministic helper scripts. There are no unrelated env vars, binaries, or config paths requested.

✓ Instruction Scope

SKILL.md explains progressive-disclosure usage and only directs the agent to read documentation files or run the included scripts on demand. The scripts operate on explicit arguments and do not instruct the agent to read arbitrary system state, secrets, or send data to external endpoints.

✓ Install Mechanism

No install spec (instruction-only) is present. The skill includes two small local scripts; nothing is downloaded or written to disk by an installer.

✓ Credentials

No environment variables, credentials, or config paths are required. The included assets/config.example.yaml is only an example file; nothing in the repo asks for secrets or unrelated service keys.

✓ Persistence & Privilege

always is false and the skill does not request permanent presence or modify other skills/system settings. Autonomous invocation is allowed by default but not accompanied by elevated privileges or broad credential access.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install acong-layout-demo
安装完成后，直接呼叫该 Skill 的名称或使用 /acong-layout-demo 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v0.1.0

Kitchen-sink layout demo: flat Level-3 refs + references/ + scripts/ + assets/ (9 files, 3 subdirs)

元数据

Slug acong-layout-demo

版本 0.1.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题