ub-authoring
Use this skill when the task involves creating, reviewing, or refactoring installable skills, shared skill references, or reusable agent-authoring guidance; when the work depends on routing-quality descriptions, non-use boundaries, naming, progressive disclosure, or cross-skill authoring conventions; or when you want to normalize skill and guidance structure without turning the task into a full customization-builder workflow. Do not use it for end-to-end customization generation, normal code implementation, or general repository planning.
How do I install this agent skill?
npx skills add https://github.com/robert-hoffmann/uncle-bob --skill ub-authoringIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides authoring guidelines and conventions for creating portable AI agent skills. It focuses on documentation structure, routing metadata, and user interaction patterns. It does not perform any network operations, execute external code, or access sensitive information.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
UB Authoring
Mission
Use this skill to shape portable, installable authoring guidance for skills and related agent-behavior surfaces.
This skill owns the reusable authoring conventions that should travel with the skill catalog itself instead of living in repo-only docs or in one customization-specific skill.
When Not To Use
- Do not use this skill for end-to-end customization generation; defer that to
ub-customizations. - Do not use this skill for ordinary code implementation or framework work where no shared authoring contract is being changed.
- Do not use this skill as a substitute for repo-local maintenance docs or packaging metadata that belong to a development repository rather than the distributable skill payload.
Embedded Contract
These rules are the base contract of this skill and must not depend on a secondary document to be applied correctly.
- Treat descriptions as routing metadata, not marketing copy.
- Add explicit non-use boundaries when wrong-skill activation is realistically costly or common.
- Prefer concrete examples and acceptance boundaries over vague admonitions.
- Keep the main skill surface lean and move deeper detail into targeted references.
- Keep shared authoring guidance portable across installed skill payloads and avoid repo-local live truth in the reusable contract.
- Keep reusable choice-question UX contracts in shared authoring guidance instead of re-encoding the same multiple-choice rules in each skill.
Load References On Demand
- Read
references/authoring-conventions.mdwhen shaping shared skill structure, cross-skill wording, routing quality, reusable choice-question UX, or other reusable authoring patterns.
Core Workflow
- Decide whether the task is changing a reusable authoring convention or a single skill's local content.
- Keep portable shared guidance in this skill and domain-specific guidance in the owning skill.
- Normalize descriptions, examples, non-use boundaries, and shared choice-question behavior only where the changed surfaces actually benefit from them.
- Keep reusable references installable and avoid dead links into repo-only docs.
Output Requirements
When producing non-trivial authoring updates, include:
routing_noteboundary_notereference_notevalidation_note
Completion Checklist
- Shared guidance remains portable inside
.agents/skills/. - Description wording reads like routing logic, not inventory prose.
- Non-use boundaries are explicit where misrouting is realistic.
- Examples are concrete where abstract guidance would be easy to misapply.
- Shared references avoid repo-only assumptions unless clearly labeled as such.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/robert-hoffmann/uncle-bob/ub-authoring">View ub-authoring on skillZs</a>