trellis-check

Verifies code changes against specs, lint, tests, and cross-layer consistency checklists.

Updated Jun 9, 2026
One-click install
npx skills add https://github.com/gyc-12/Archipelago --skill trellis-check-gyc-12
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trellis-check
Source: https://github.com/gyc-12/Archipelago/tree/main/.cursor/skills/trellis-check
Command: npx skills add https://github.com/gyc-12/Archipelago --skill trellis-check-gyc-12

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After writing code, it is easy to miss spec violations, broken tests, leftover debug logging, or inconsistencies across architectural layers. This Skill provides a structured quality verification workflow that catches these issues before committing changes. ## Core Features & Use Cases - Spec Compliance Verification: Reads applicable Trellis spec indexes and guideline files for each changed package or layer to confirm the code follows documented conventions. - Project Checks: Runs the project's lint, type-check, and test commands and requires all failures to be fixed before proceeding. - Cross-Layer Review: Checks data flow (Storage → Service → API → UI), code reuse, import/dependency correctness, and same-layer consistency when changes span multiple layers. - Use Case: After implementing a feature touching the API and UI layers, run this check to confirm types propagate correctly, tests were added for new functions, and the spec docs are updated with any lessons learned. ## Quick Start Run the trellis-check quality verification on my recent uncommitted changes and fix any violations found.

Frequently Asked Questions about trellis-check

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify code quality before committing changes?

Run this verification workflow: identify changed files with git diff, read applicable spec guidelines, execute the project's lint, type-check, and test commands, then review against the checklist covering debug logging, test coverage, and spec sync. Fix all failures before committing.

How to check cross-layer data flow in a multi-layer codebase?

Trace read flows from Storage through Service and API to UI, and write flows in reverse. Confirm types and schemas pass correctly between layers and that errors propagate properly to callers. This applies when changes touch three or more layers.

When should I update spec documentation after a code change?

Update specs when you fix a bug, discover a non-obvious pattern, or establish a new convention. The guiding question is whether documenting it would prevent future developers from hitting the same issue.

What test coverage should accompany new code changes?

New functions require unit tests, bug fixes require regression tests, and changed behavior requires updating existing tests. The checklist enforces these mappings during the review step.

When can I skip the cross-layer consistency checks?

Skip the cross-layer dimensions when your change is confined to a single layer. The data flow, code reuse, import, and consistency checks only apply to changes spanning multiple architectural layers.