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.