skills.rest
nebius
nebiusOFFICIAL
Explore all skills by this author →
WebsiteGitHub

align

Align code, tests, docs, and CI after changes with changed-scope quality gates.

7|5|Updated Jul 22, 2025
Search Tags:#code review#consistency#refactoring#validation#quality gate#ci#code alignment
One-click install
npx skills add https://github.com/nebius/nebius-ps-services --skill align-nebius
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: align
Source: https://github.com/nebius/nebius-ps-services/tree/main/skills/align
Command: npx skills add https://github.com/nebius/nebius-ps-services --skill align-nebius

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? After code changes, projects often drift out of sync: tests contradict implementation, docs describe stale behavior, CLI help text mismatches flags, and CI workflows reference broken paths. This Skill performs an evidence-driven alignment pass that finds and safely fixes these inconsistencies, then validates the changed scope with code review, lint, security, and focused test gates. ## Core Features & Use Cases - Contract-First Alignment: Infers the intended project contract from READMEs, tests, CI workflows, CLI help output, and working code before making minimal, reviewable fixes. - Changed-Scope Quality Gate: Runs mandatory validation lanes including report-only code review, lint/syntax checks, security review, cross-code wiring checks, and focused tests or builds. - Safe Remediation Policy: Fixes only clear, low-risk issues, preserves unrelated dirty files and caller-supplied finding classifications, and reports risky or ambiguous changes for explicit approval. - Use Case: After a refactoring session, invoke the Skill to reconcile implementation, tests, docs, and workflows, then receive a report of fixes made, gate results, and remaining risks. ## Quick Start Ask the agent to run align on the current project to reconcile recent changes across code, tests, docs, and CI, then report the quality-gate results.

Frequently Asked Questions about align

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

FAQPage Schema
How do I keep code, tests, and docs consistent after refactoring?▼

Run an alignment pass that compares implementation against tests, CLI help, workflows, and documentation, then patches confirmed mismatches. The align skill fixes low-risk inconsistencies and validates the changed scope with review, lint, security, and test gates.

What is a changed-scope quality gate in code review?▼

A changed-scope quality gate validates only the files and dependencies affected by recent changes rather than scanning the whole repository. It typically includes cross-code wiring checks, code review, lint or syntax checks, security review, and focused tests or builds.

Does align modify unrelated dirty files in the working tree?▼

No. The skill separates requested or agent-touched changes from unrelated dirty files and only reports the unrelated ones. It edits only within the active changed scope and its direct dependencies.

When should I use align instead of a standalone code review?▼

Use align when you want safe fixes applied plus validation across code, tests, docs, and CI, not just findings. Use a standalone code review when you only need a report on a specific diff without any remediation.

What happens if the security validation lane cannot run?▼

The skill attempts to resolve the apply-security skill from the session, sibling paths, or installed skill locations. If it cannot be loaded, the security lane is reported as blocked or skipped with the paths checked, and alignment is not claimed complete.

Related Skills

Explore More Software Engineering Skills→
OlatisunkanmiOlatisunkanmi
8

pr-summary

Generate concise pull request summaries from branch diffs and git history.

Community
Basic
mitsuhikomitsuhiko
3.0k

update-changelog

Updates repository changelogs with notable commits since the last git tag.

Community
Basic
human-centric-engineeringhuman-centric-engineering

pr-gates

Runs pre-merge validation, coverage, security, and code review gates on a branch and fixes findings until clean.

Official
Advanced
MaelwalserMaelwalser

plankton-code-quality

Run formatters and linters on every file edit with Claude subprocess remediation.

Community
Advanced