Index of every page on this site: llms.txt
All skills
a2ui-project avatar

/coding-principles

@6bf4cc2
by A2UIa2ui-project/a2ui18k stars
1,430
Run it yourself

Enforces engineering, architecture, public API, and code quality standards distilled from human reviewer feedback across A2UI pull requests. Use when authoring new code, refactoring, addressing review feedback, or reviewing PR diffs. Don't use for release publishing or spec blueprint generation without code or PR changes.

  • 17 files
  • 75.1 KB
  • Updated 2 weeks ago
  • GitHub
Use this Skill: https://skilld.dev/gh/a2ui-project/a2ui/coding-principles

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

subskillspythonINDEX.md

≈512 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Python Progressive Discovery Router

Use this router whenever a pull request or local change modifies Python files across python/, eval/, samples/agent/, tools/, or scripts/.


Evaluate Python Subskill Triggers

Inspect the Python files in git diff main --stat and read the subskill documents below whose activation criteria match your changes:

1. Package Architecture, Boundaries & Public Facades

  • Document: architecture-and-facades.md
  • Activate if:
    • Any package boundary or module layout under python/ (a2ui_core, a2ui_agent, a2ui.builder, catalogs/mcp) is modified.
    • Package entrypoints (__init__.py, __all__) or cross-package imports are added or modified.
    • Protocol schemas, component catalogs, or constants (SPEC_VERSION, PROTOCOL_VERSION) are touched.
    • Examples, docstrings, READMEs, or sample agents demonstrate package imports.

2. Python Coding Standards, Typing, Error Hierarchy & Verification

  • Document: coding-standards-and-verification.md
  • Activate if:
    • Any Python source or test file (*.py) is added, modified, or refactored.
    • Pydantic v2 models, type annotations, or serialization logic (model_dump, TypeAdapter) are touched.
    • Exceptions (A2uiError subclasses) or validation error paths are added or modified.
    • Parsers, prompt generators, or compilers are updated (enforces catalog-agnostic design).
    • Running local formatting (pyink), type checking (mypy), unit testing (pytest), or package builds (uv build).

3. Specialized Task Skills (Load Only When Applicable)

  • Generating Pydantic Models from JSON Schemas: Read a2ui-generate-pydantic-models when regenerating or updating schema-backed Pydantic models.
  • Releasing Python Packages to PyPI: Read a2ui-release-python when cutting a release for a2ui-core or a2ui-agent-sdk.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at 6bf4cc2. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 weeks ago
metadata
{
  "internal": true
}

README badge

README badge for a2ui-project/a2ui/coding-principles