skill-authoring
Creates and updates canonical Agent Skills in the Scientific Agent Skills repository while preserving scope, frontmatter, progressive disclosure, versioning, tests, catalog entries, and diagram policy. Use for new skills, skill revisions, metadata fixes, references/scripts/assets placement, or contribution checklists.
- License 许可
- MIT
- 最近更新
- 2026-10-08
- Stars
- ★ 11
- Forks
- 3
01 前言 Front Matter
- name
- skill-authoring
- license
- MIT
- metadata
- { "disco-role": "operating" }
- description
- Creates and updates canonical Agent Skills in the Scientific Agent Skills repository while preserving scope, frontmatter, progressive disclosure, versioning, tests, catalog entries, and diagram policy. Use for new skills, skill revisions, metadata fixes, references/scripts/assets placement, or contribution checklists.
- disable-model-invocation
- true
02 资源文件 4
- 参考文档references/authoring-workflows.md2.2 KB
- 参考文档references/catalog-and-diagrams.md1.8 KB
- 参考文档references/frontmatter-and-layout.md2.0 KB
- 参考文档references/troubleshooting.md1.9 KB
03 SKILL.md 正文
Skill Authoring
Use this route when the task changes a canonical skill under skills/<name>/.
Before editing
- Read the existing
SKILL.mdand every linked local reference/script that the change may affect. - Read
AGENTS.mdand the relevantCONTRIBUTING.mdsection. - Decide whether the request is a new skill, an update, or a scope correction. Do not create a broad orchestrator skill merely because several neighboring skills exist.
- Use current upstream package/platform documentation for API claims; keep untested behavior explicitly illustrative.
Read references/authoring-workflows.md for the new/update checklists and references/frontmatter-and-layout.md for the exact structural contract. Use scripts/audit_skill_frontmatter.py for a fast local preflight before the repository validator.
New skill route
- Create
skills/<name>/with a matching lowercase-hyphenSKILL.md. - Put only runtime content in the skill directory:
SKILL.md,references/,scripts/, and usefulassets/. - If the skill ships scripts, create tests under
tests/<name>/and add a matching entry totests/skill-requirements.toml. - Keep the root document router-like; move long API tables, examples, data schemas, and troubleshooting matrices into references.
- Update the public catalog and any required generated diagram only after the content is final. Read
references/catalog-and-diagrams.mdbecause this checkout may not contain the diagram generator named by repository policy.
Existing skill update route
- Make the smallest useful change and preserve unrelated behavior.
- Bump the quoted
metadata.versionin the same change. - Re-run touched examples/scripts and the skill's own test suite.
- Re-check local links, line count, optional dependency claims, credentials, and safety boundaries.
- If the workflow or references changed materially, regenerate the diagram when the required tool is available; a typo/link/version-only change does not require an image refresh.
Exit handoff
Before handing off, report the skill directory, files changed, evidence consulted, intentional omissions, version bump, test/validation commands to run, catalog/diagram status, and any upstream or environment uncertainty. Route execution to validation-testing, then route scanner review to security-scanning.
04 同仓库更多 Skills
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
python-api
Programmatic Object-Detection-Metrics API guidance for BoundingBox, BoundingBoxes, Evaluator, enums, coordinate conversion, AP/mAP semantics, and source-style import diagnostics.
file-evaluation
Folder-based PASCAL VOC AP/mAP evaluation from ground-truth and detection text files.
object-detection-metrics
Guides legacy Object-Detection-Metrics PASCAL VOC AP/mAP evaluation from detection text folders and direct Python API classes.
nx-workspace-patterns
Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.