describe-capability
/describe-capability
Create or maintain .dev capability.json files when documenting or changing what a folder can do and who may ask for it.
- Repository
- retro-games ↗
- Licence
- MPL-2.0
- Last repository change
- 12.11.2026
Assessment and security
- Files in this package
- 3
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 12.11.2026, without references to retired models or APIs.
MPL-2.0, otwarta.
What it does and when to use it
Create or maintain .dev capability.json files when documenting or changing what a folder can do and who may ask for it.
Original author description
Create or maintain .dev capability.json files when documenting or changing what a folder can do and who may ask for it.
How it works
SKILL.md has no level-two headings · 15 lines, 488 words
SKILL.md preview
--- name: describe-capability description: Create or maintain .dev capability.json files when documenting or changing what a folder can do and who may ask for it. --- # Capabilities A capability is a coherent area of what the system can do, organized around a domain responsibility, a device or an outside service, with a set of related operations through which it is reached. Describe them in `<folder>/.dev/capability.json`: one entity per capability, named as a noun phrase (`name`), with its `responsibility` in a sentence, who may use it (`access`, one line per rule, as the code enforces it; if nothing checks, say so) and the `operations` through which it is reached, as source and symbol, at the boundary that owns them. A capability needs both a cohesive responsibility and a callable interface. An adapter, a namespace, a collection of models, a scheduler wrapper or a folder that only wires things together is not one on its own. Do not make one per class, and do not call every method a capability. Link the features that make it up, the operations that expose it and the use cases that use it with `relatedViews`. These views overlap and are not a hierarchy. A capability organizes what a folder can do; an operation is one way in; a feature is behavior the product offers; a use case is one actor's goal, step by step; a user journey is a person's experience over time, across use cases. A folder may need several of them, or none. Read the child folders' views first, then the folder's own source, its public interfaces and the code that wires it together, bottom up, leaving out `.dev`, build output and third-party code. Write the view in the folder that owns the behavior, not in the nearest ancestor. A grouping folder gets a view only when its own code establishes it. Keep the architecture diagrams; these views complement them. If nothing establishes this kind, write nothing: no placeholder files. Write following [schema.json](schema.json); [example.json](example.json) is fictional and is not evidence about this system. A file may hold several entities, with IDs unique in the file. Every entity cites the files and exact symbols that establish it, and so does every step, stage and alternative that has them. `$schema` is the path from the file to the schema; every other path is relative to the repository root. A related view must exist, be of the kind and folder it claims, and be related by evidence; it need not be in a child folder. Never copy a child's internals into its parent: link to them. Run `python3 Meta/Agents/Skills/validate_diagrams.py` from the repository root, with `jsonschema` installed. It checks the schema, unique IDs, that sources and related views exist and agree, and that every `actorDocument` lands on a file in `Actors/`. Then read the claims against the sources: a file that passes is well-formed, not true. No secrets, configuration values or method bodies. Do not run the system or its infrastructure to document it. Update the view in the same commit as the code, and delete it when it stops applying.
Files in this package (3)
- example.json 1 KB
- schema.json 4 KB
- skill.md 3 KB
Versions
The database has no other skills named describe-capability.
Database snapshot: 13.11.2026 · package version 5b530c91f5f0 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100create-capability
Author a new Routecraft capability (workflow, automation, MCP tool, webhook handler, or scheduled job). Use when the user asks to compose adapters into a pipeline. - 100capability-creator
Guide for assembling a workspace capability (skills + integrations). Use when the user wants to create a capability. - 100simready-foundation-update-capability
Use for updating SimReady capability docs, requirement indexes, validation registration, and feature references. - 100output-dev-scenario-file
Create test scenario JSON files for Output SDK workflows. Use when creating test inputs, documenting expected behaviors, or setting up workflow testing. - 100esp32-board-capability-matrix
Use when reviewing or implementing esp32 board capability matrix on an ESP32 target., including target-specific constraints and repeatable validation steps. - 100output-dev-folder-structure
Workflow folder structure conventions for Output SDK. Use when creating new workflows, organizing workflow files, or understanding the standard project layout.