Skip to content
Skills Library
Design & UX · Review & audit

verifying-interface-completeness

/verifying-interface-completeness

Use when verifying interface completeness is required during ux work, especially when the result must be traceable, independently reviewable, and safe to hand to another agent.

Repository
forge-os ↗
Licence
MIT
Last repository change
01.08.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 01.08.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Use when verifying interface completeness is required during ux work, especially when the result must be traceable, independently reviewable, and safe to hand to another agent.

Original author description

Use when verifying interface completeness is required during ux work, especially when the result must be traceable, independently reviewable, and safe to hand to another agent.

How it works

  1. Overview
  2. Trigger
  3. Required Inputs
  4. Method-Specific Protocol
  5. Procedure
  6. Verification Questions
  7. Evidence Packet
  8. Output Contract
  9. Quality Gate
  10. Forbidden Shortcuts
Original SKILL.md headings · 122 lines, 937 words
SKILL.md preview
---
name: verifying-interface-completeness
description: "Use when verifying interface completeness is required during ux work, especially when the result must be traceable, independently reviewable, and safe to hand to another agent."
license: MIT
compatibility: "ForgeOS-compatible Agent Skills hosts; no provider-specific model required."
metadata:
  author: forgeos-community
  version: "0.2.0"
  pack: ux
  kind: core
  status: candidate
---

# Verifying Interface Completeness

## Overview

This skill owns one bounded responsibility: **verifying interface completeness**. Its focus is verifying interface completeness within ux lifecycle boundaries. It converts declared inputs into typed artifacts and reproducible evidence without silently changing product scope.

## Trigger

Activate only when the project is in one of these stages: `ux-design`, all contract preconditions pass, and the router identifies a missing output this skill can produce. Do not activate merely because the skill name resembles the user request.

## Required Inputs

- `product-definition`
- `user-workflows`
- Current gate result, open findings, artifact hashes, and invalidation state
- Required tools: none
- Optional tools: `browser`
- Confirmed human decisions relevant to this scope

## Method-Specific Protocol

1. Define the exact decision, actors, objects, states, invariants, side effects, and non-goals owned by verifying interface completeness.
2. Build a decision table for normal, boundary, invalid, permission, failure, retry, recovery, concurrency, migration, and abuse conditions relevant to verifying interface completeness.
3. Apply verifying interface completeness only to direct input artifacts; record assumptions, rejected alternatives, and any human decision still required.
4. Trace the resulting contract to user value, security, reliability, cost, operability, and downstream consumers.
5. Create reproducible checks that would fail if verifying interface completeness were incomplete or implemented incorrectly.

## Procedure

1. Read user workflows, constraints, devices, and accessibility needs.
2. Define critical journeys and failure recovery before visual styling.
3. Define the exact decision, actors, objects, states, invariants, side effects, and non-goals owned by verifying interface completeness.
4. Build a decision table for normal, boundary, invalid, permission, failure, retry, recovery, concurrency, migration, and abuse conditions relevant to verifying interface completeness.
5. Apply verifying interface completeness only to direct input artifacts; record assumptions, rejected alternatives, and any human decision still required.
6. Trace the resulting contract to user value, security, reliability, cost, operability, and downstream consumers.
7. Create reproducible checks that would fail if verifying interface completeness were incomplete or implemented incorrectly.
8. Specify interaction states, information hierarchy, and feedback.
9. Create responsive and accessible behavior contracts.
10. Validate critical flows against realistic user tasks.
11. Publish UI evidence, open questions, and handoff contracts.

## Verification Questions

- Does the artifact make the owned decision for verifying interface completeness explicit and bounded?
- Are failure, recovery, permissions, concurrency, and irreversible side effects addressed where applicable?
- Can every load-bearing claim be traced to a confirmed fact, direct artifact, executable check, or declared assumption?
- Would a downstream agent know exactly what changed, what remains open, and what must be invalidated?

## Evidence Packet

Produce or reference all applicable evidence:

- `verifying-interface-completeness-decision-table`
- `verifying-interface-completeness-verification-report`
- `verifying-interface-completeness-handoff-envelope`

Evidence must identify the current artifact hash, command or method used, result, reviewer identity, timestamp, and limitations.

## Output Contract

Produce:
- `ux-contract`

The primary artifact must include schema version, provenance, consumed artifact IDs, decisions, evidence references, residual risks, validation state, and invalidation targets. Narrative explanation may accompany the artifact but cannot replace it.

## Quality Gate

Reviewer: `independent-reviewer`

- The output directly and completely performs verifying interface completeness within its declared boundary.
- Does the artifact make the owned decision for verifying interface completeness explicit and bounded?
- Are failure, recovery, permissions, concurrency, and irreversible side effects addressed where applicable?
- Can every load-bearing claim be traced to a confirmed fact, direct artifact, executable check, or declared assumption?
- Would a downstream agent know exactly what changed, what remains open, and what must be invalidated?
- Every material claim is traceable to an input, decision, executable check, or evidence item.
- Required fields are complete and machine-readable.
- The producing agent is not the approving reviewer.
- Open uncertainty and residual risk are explicit; critical findings are never hidden by an aggregate score.

Pass only when: All mandatory rules pass, evidence targets the current artifact hash, and no unresolved critical finding applies.

## Forbidden Shortcuts

- Do not infer a material requirement that the user has not confirmed.
- Do not replace a typed artifact with a long explanation.
- Do not approve work produced by the same agent identity.
- Do not hide a critical failure behind a high aggregate score.
- Do not load unrelated project history, files, references, or skill bodies.
- Do not mark evidence complete when it targets a different artifact hash or version.

## Failure Modes

- guessing a material requirement
- producing prose without the contracted artifact
- self-approving the output
- expanding scope without a decision record
- treating verifying interface completeness as a naming exercise
- covering only the happy path
- creating extension points without a current contract or consumer

## Escalation and Invalidation

Stop and request a human decision when scope, risk acceptance, irreversible action, cost ceiling, privacy boundary, or product direction is materially ambiguous. When this artifact changes, invalidate only descendants named by the artifact graph; preserve unaffected verified branches.

## Handoff

- Next transition: the graph router selects a real consumer of `ux-contract`.
- Required evidence: `contract-validation`, `independent-review`, `verifying-interface-completeness-decision-table`, `verifying-interface-completeness-verification-report`, `verifying-interface-completeness-handoff-envelope`.
- Required envelope fields: `artifactId`, `schemaVersion`, `sha256`, `producingSkill`, `producingAgent`, `consumedArtifacts`, `decisionIds`, `evidenceIds`, `residualRisks`, `validationState`, `invalidationTargets`, `stopCondition`.
- Stop condition: Output contract is satisfied, a blocker is recorded, or a material human decision is required.

## Token and Context Policy

Load at most 8 direct artifacts and reference depth 1. Use stable IDs, hashes, signatures, and deltas instead of repeating full history. Use established domain terminology, state each requirement once, and spend context on decisions, code, tests, or evidence rather than narration.

## Reference Playbook

Load [skills/references/core/ux.md](../../../references/core/ux.md) only when this skill needs pack-wide decision tables, evidence patterns, or cross-skill handoff rules.

See `contract.json` for the machine-readable contract.
Files in this package (2)
  • SKILL.md 7 KB
  • contract.json 6 KB

Versions

The database has no other skills named verifying-interface-completeness.

Database snapshot: 13.11.2026 · package version 1e7875f589a0 (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

  • 90writing-agent-skills
    Use when writing agent skills is required during meta work, especially when the result must be traceable, independently reviewable, and safe to hand to another agent.
  • 90evaluating-ai-quality
    Use when evaluating ai quality is required during ai-products product work, especially when the result must be traceable, independently reviewable, and safe to hand to another agent.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.