skill-authoring SKILL.md skillA
skill-authoring from uvwt/agentdock is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add uvwt/agentdock/skill-authoring@git:20260925.a4848d1Pins git:20260925.a4848d1 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- uvwt/agentdock
- Path
core-skills/skill-authoring/SKILL.md- Versions recorded
- 6
- Latest version
- git:20260925.a4848d1, committed Sep 25, 2026
- First version recorded
- Aug 2, 2026
- Size
- 10,213 bytes
- Repository stars
- 1,289
- License
- Apache-2.0
创建、设计、修改、重构和验证 AgentDock Skill 时使用；负责 Agent Skills 兼容的 SKILL.md、可移植核心、引用、辅助脚本、测试、安全边界和本地真实验证。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Skill Authoring 用于创建或维护 AgentDock Skill。Skill 的本体是模型可读取的说明文档；真实操作仍由命令、文件、浏览器、MCP 等工具完成。 AgentDock 不为 Skill 建立独立版本生命周期。Skill 的当前内容由来源与内容摘要识别；同名 managed Skill 更新时直接原子替换当前内容，不保留可选历史 revision，不提供 activate 或 rollback。 ## 核心原则 1. 先定义模型何时应该选择该 Skill，再写正文。 2. Skill 核心应兼容 Agent Skills 的文档模型，不把 AgentDock 私有运行时当作通用契约。 3. 最小 Skill 只有一个 `SKILL.md`；只有确有需要时才增加 `references/`、脚本或测试。 4. 包内资源使用相对路径，业务环境变量由宿主注入当前进程。 5. 秘密、缓存、会话、数据库、下载结果和设备私有状态不得进入 Skill 包。 6. 修改后必须真实 lint、测试，并在需要时安装到 AgentDock 验证当前内容。 7. 不创建或恢复 Skill 自有版本选择、激活、回滚或历史 revision 机制。 完整规范见 `references/skill-package-spec.md`。 ## 目录 普通第一方和社区 Skill 默认放在独立 Skill 仓库： ```text skills/<skill-name>/ └── SKILL.md ``` 按需扩展： ```text skills/<skill-name>/ ├── SKILL.md ├── references/ ├── scripts/ ├── run.py └── tests/ ``` 只有必须随 AgentDock runtime 一起交付的核心 Skill 放在： ```text core-skills/<skill-name>/ ``` 不要创建空目录。 ## SKILL.md Frontmatter AgentDock 使用 Agent Skills 风格的字段： ```yaml --- name: example-skill description: 清楚说明何时使用、解决什么问题 license: Apache-2.0 compatibility: Requires Python 3.11 or later. metadata: owner: example-team allowed-tools: exec_command --- # Example Skill ``` AgentDock 真正依赖并严格校验的只有： …
Read the whole file at its exact version.
How to install
mdr add uvwt/agentdock/skill-authoring@sha256:1b739bac7851f5c9The line at the top of this page pins the label git:20260925.a4848d1, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_agl4m4hifkdqcpmv)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 6 versions of this file, between Aug 2, 2026 and Sep 25, 2026, about one every 11 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260925.a4848d1 latest | 2026-09-25 | a4848d1 | 10,213 B | A | view · diff |
| git:20260924.b36b40f | 2026-09-24 | b36b40f | 9,177 B | A | view · diff |
| git:20260923.120527c | 2026-09-23 | 120527c | 9,268 B | A | view · diff |
| git:20260923.c3db3f1 | 2026-09-23 | c3db3f1 | 8,832 B | A | view · diff |
| git:20260922.174237a | 2026-09-22 | 174237a | 8,602 B | A | view · diff |
| v1.2.0 | 2026-08-02 | f4d7a20 | 11,695 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (10213 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
uvwt/agentdock · 1,289 stars · license Apache-2.0 · pushed 2026-10-27 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_agl4m4hifkdqcpmv GET https://markdownregistry.com/api/v1/resolve?ref=uvwt/agentdock/skill-authoring GET https://markdownregistry.com/api/v1/blob/1b739bac7851f5c95beebbf8df37383a09584425b61a4066b9e1ff443079d0a0
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.