Ub Authoring

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.

1. Treat descriptions as routing metadata, not marketing copy.
2. Add explicit non-use boundaries when wrong-skill activation is realistically

costly or common.

1. Prefer concrete examples and acceptance boundaries over vague admonitions.
2. Keep the main skill surface lean and move deeper detail into targeted

references.

1. Keep shared authoring guidance portable across installed skill payloads and

avoid repo-local live truth in the reusable contract.

1. 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.md when shaping shared skill

structure, cross-skill wording, routing quality, reusable choice-question UX, or other reusable authoring patterns.

Core Workflow

1. Decide whether the task is changing a reusable authoring convention or a

single skill's local content.

1. Keep portable shared guidance in this skill and domain-specific guidance in

the owning skill.

1. Normalize descriptions, examples, non-use boundaries, and shared

choice-question behavior only where the changed surfaces actually benefit from them.

1. Keep reusable references installable and avoid dead links into repo-only

docs.

Output Requirements

When producing non-trivial authoring updates, include:

1. routing_note
2. boundary_note
3. reference_note
4. validation_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.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: robert-hoffmann
• Source: robert-hoffmann/uncle-bob
• License: MIT
• Homepage: https://robert-hoffmann.github.io/uncle-bob/

Install and usage instructions live in the source repository linked above.