Scaffold: New Low-Level Ability

This document is an entrypoint for low-level ability scaffolding. The step-by-step flow is in /.system/skills/ssot/repo/scaffolding/new-ability-low/SKILL.md.

1. Purpose & Scope

Purpose: Register a new low-level ability in the ability registry and update relevant ABILITY.md index files.

Scope:

•Creates ability registration in /.system/registry/low-level/
•Regenerates ABILITY.md indexes for specified entrypoints
•Validates implementation references

Out of scope:

•Implementing the actual script/API/MCP handler
•High-level workflow/agent abilities
•Hook bindings (added separately)

2. Inputs & Preconditions

Required Inputs

Parameter	Type	Description
`operation_key`	string	Unique operation identifier (e.g., `skills.sync_wrappers`)
`summary`	string	One-line description of what this ability does
`kind`	enum	Implementation type: `script`, `api`, `mcp`
`entrypoints`	array	ABILITY catalog roots where ability appears (e.g., `/modules/integration`)

Conditional Inputs (based on `kind`)

The implementation sub-object contains kind-specific fields:

Parameter	Condition	Description
`implementation.script`	kind=script	Path to script (repo-root absolute, e.g., `/scripts/my_op.py`)
`implementation.command`	kind=script	Shell command template (alternative to script)
`implementation.api_endpoint`	kind=api	API endpoint URL or reference
`implementation.mcp_tool`	kind=mcp	MCP tool name

Note: For kind=script, either implementation.script or implementation.command is required.

Optional Inputs

Parameter	Type	Default	Description
`parameters`	object	{}	JSON Schema for input parameters
`tags`	array	[]	Classification tags

Preconditions

•Phase 4 registry tooling is available (scripts/devops/registry/abilities.py)
•operation_key does not already exist in ability registries
•Specified entrypoints have valid ABILITY.md files with marker blocks
•Implementation reference (script/api/mcp) is valid or will be created

3. Step-by-Step Flow (AI + Human)

See /.system/skills/ssot/repo/scaffolding/new-ability-low/SKILL.md.

4. Tools & Scripts

Tool	Purpose
`scripts/devops/scaffold/new_ability_low.py`	Orchestrator script
`scripts/devops/registry/abilities.py`	Registry validation and index regeneration
`scripts/devops/registry/common.py`	Shared utilities

5. Outputs & Side Effects

Files Created/Modified

code

/.system/registry/low-level/<operation_key>.yaml   # New registry entry
<entrypoint>/ABILITY.md                            # Index block regenerated

Registry Entry Structure

yaml

operation_key: skills.sync_wrappers
summary: Regenerate provider skill wrappers from SSOT
kind: script
entrypoints:
  - /modules/integration
implementation:
  script: /scripts/devops/skills/sync_skills.py
  command: python scripts/devops/skills/sync_skills.py --regenerate --target integration --publish-set integration_default
parameters:
  type: object
  properties:
    regenerate:
      type: boolean
      description: Whether to regenerate wrappers

Note: The implementation sub-object contains kind-specific fields. For kind=script, at least one of script or command is required.

6. Safety & Rollback

Safety Measures

•--dry-run always available for preview
•Human approval required before execution
•Schema validation on registry entry
•Consistency checks via abilities.py --check

Rollback Procedure

If registration fails or needs reverting:

•Delete the registry entry:

bash

rm /.system/registry/low-level/<operation_key>.yaml

•Regenerate ABILITY.md indexes: