code-style

Enforces TypeScript and Astro code-style conventions and runs a complexity-only simplicity review.

Updated Sep 6, 2026
One-click install
npx skills add https://github.com/malikkotb/shellpluscore --skill code-style-malikkotb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-style
Source: https://github.com/malikkotb/shellpluscore/tree/main/.agents/skills/code-style
Command: npx skills add https://github.com/malikkotb/shellpluscore --skill code-style-malikkotb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Codebases drift into inconsistent formatting, one-line conditionals, and accumulated dead code over time. This Skill standardizes how TypeScript and Astro code is written in this repo and provides a structured review lens for finding duplication, dead code, and unnecessary complexity. ## Core Features & Use Cases - Style conventions: Braced control flow with blank-line spacing, type over interface, naming rules for identifiers and files, minimal comments, ~/ path-alias imports, and Biome formatting. - Simplicity review: A complexity-only audit producing one-line findings tagged dup:, delete:, stdlib:, native:, shrink:, or speculative:, with grep-verified claims and a net line-count score. - Use Case: After writing a new Astro component, ask for a style pass to convert one-line if statements into braced blocks, fix import aliases, and then run a simplicity review on the diff to find copy-pasted helpers that should be extracted. ## Quick Start Review my recent TypeScript changes for code-style violations and run a simplicity review on the diff to find duplication and dead code.

Frequently Asked Questions about code-style

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

FAQPage Schema
How do I enforce consistent code style in TypeScript and Astro files?

Apply the repo conventions: braced if/else blocks with blank-line spacing, type over interface, camelCase functions and PascalCase types, and ~/ path-alias imports. Run npm run format so Biome applies double quotes, semicolons, and line width 130.

How to find dead code and duplication in a codebase?

Run a simplicity review over the diff or whole repo. It emits one-line findings tagged dup, delete, stdlib, native, shrink, or speculative, with every dead-code claim verified by grep across src, sanity, templates, and scripts before reporting.

Should I use type or interface in TypeScript?

Prefer type for object shapes, props, and contracts, including Astro component Props. The only exception is ambient declaration-merging blocks such as ImportMetaEnv in env.d.ts, which must use interface because type cannot merge declarations.

Does Biome format Astro template markup?

No. Biome only sees the frontmatter of .astro files, so template markup must be kept consistent by hand. Biome does enforce braced statements via useBlockStatements, but the blank-line spacing between blocks is a manual convention.

When should code not be flagged as unnecessary complexity?

Do not flag single-implementation abstractions that are documented extension seams, such as Plop templates, create-* schema factories, or anything a SKILL.md or docs file names as an edit point. Flag speculative code only when grep shows zero usage and no documented purpose.