Boring Engineering

Prevents overengineering when designing, implementing, refactoring, or reviewing software. Use when the user asks to implement a feature, add an abstraction, refactor code, review a design, simplify existing code, or make an architectural decision. Also triggers when the user asks if code is too complex, whether to abstract something, or how to structure something. Do not use for deployment, infrastructure configuration, or debugging runtime errors unrelated to code structure.

24 stars 3 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add alvindemesadev/boring-engineering --skill boring-engineering
Manual install
git clone --depth 1 https://github.com/alvindemesadev/boring-engineering.git /tmp/boring-engineering
mkdir -p ~/.claude/skills
cp -r /tmp/boring-engineering/. ~/.claude/skills/boring-engineering

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Boring Engineering

Build exactly what the current problem requires. No less, no more.

## Step 1 — Requirement Filter (YAGNI)

Before writing any code, ask: is this explicitly required by the current task or an explicit stakeholder requirement?

- NO → Do not build it. Stop.
- YES → Continue to Step 2.

If uncertain, default to not building it. A missing feature is easier to add than a wrong abstraction is to remove.

## Step 2 — Reuse Check

Ask: does something already exist in the codebase that solves this?

- YES → Reuse it. Stop.
- NO → Continue to Step 3.

Search the codebase before implementing. Prefer extending an existing solution over creating a parallel one.

## Step 3 — Simplicity Check (KISS)

Ask: what is the simplest correct implementation?

First, name the built-in. Before writing any parsing, formatting, validation, retry, or data-shaping logic, name the standard library or platform feature that already does it. If you can name it, use it — even if you have to look up its exact API. Hand-rolling a built-in is a defect, not a style choice.

Use current idiomatic language features — modern syntax is typically shorter and clearer. But existing project conventions win: a codebase on old style stays old style.

Choose the implementation that a reasonably experienced developer can understand without explanation.

Prefer:
- Direct over indirect
- Flat over nested
- Explicit over generic
- Inline over extracted (when logic is used only once)
Read the full skill on GitHub

Details

Skill name
boring-engineering
License
MIT
Repo updated
26 August 2026

FAQ

What does the Boring Engineering skill do?

Prevents overengineering when designing, implementing, refactoring, or reviewing software. Use when the user asks to implement a feature, add an abstraction, refactor code, review a design, simplify existing code, or make an architectural decision. Also triggers when the user asks if code is too complex, whether to abstract something, or how to structure something. Do not use for deployment, infrastructure configuration, or debugging runtime errors unrelated to code structure.

How do I install the Boring Engineering skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add alvindemesadev/boring-engineering --skill boring-engineering. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Boring Engineering popular?

It lives in alvindemesadev/boring-engineering, which has 24 GitHub stars and 3 forks.

Related skills

Nexcanvas Drawio

24

sunniie/nexcanvas-drawio

Create, repair, convert, render, and verify editable Draw.io diagrams for software, cloud, data, security, delivery, product, and AI/ML architecture. Use for architecture maps, workflows, flowcharts, ERDs, sequences, BPMN, network views, wireframes, .drawio files, or PNG/SVG/PDF diagram exports.

Software Development

Snowball CLI

24

baixianger/snowball-cli

雪球股票数据命令行工具。当用户需要查询中国 A 股、港股、美股行情,查看上市公司财报、资金流向、股东信息,浏览雪球大 V 观点、热帖、实时快讯,或者做基金净值查询时,使用此技能。触发词包括:雪球、A股、港股、沪深、茅台、宁德时代、SH600519、SZ300750、基金净值、KOL、热帖、大 V、选股、K线、盘口、利润表、资产负债表、资金流向、大宗交易、融资融券。即使用户只是说「茅台现在多少钱」「今天市场怎么样」「张坤最近说了什么」也应该使用此技能。

Software Development

Recommendations

27

tasteray/skills

TasteRay API integration for personalized recommendations across verticals (movies, restaurants, products, travel, jobs). Use when you need to: (1) recommend movies, restaurants, products, travel, or jobs, (2) answer "what would I like" questions, (3) provide personalized recommendations based on preferences, (4) rank or score items for a user, (5) explain why something matches a user's taste, (6) build recommendation context from conversation, (7) integrate psychological profiles with recommendation systems.

Software DevelopmentIn 1 list

Rails Conventions

19

ethos-link/rails-conventions

Modern Ruby and Rails application architecture, implementation, and review guidance for production codebases. Use when building or reviewing Ruby on Rails 8 features across models, controllers, routes, Hotwire, jobs, APIs, performance, security, and testing. Trigger for requests mentioning Rails 8, Active Record, Active Job, GoodJob, Solid Queue, Turbo/Stimulus, REST resources, migrations, code quality, naming, and production readiness.

Software DevelopmentIn 1 list

Repl Scratchpad

24

knot0-com/repl-scratchpad

Use instead of chaining 3+ Bash calls, grep/cat/find pipelines, or any multi-step data processing. This skill should be used when the user asks to "start a scratchpad", "use the REPL", "scratchpad mode", "persistent Python session", or when a task involves exploration, analysis, or file processing that would benefit from composing operations in code rather than making individual tool calls. It creates a persistent Python REPL via tmux where variables survive across turns and only print() output enters context — a context-efficient alternative to Bash for data-heavy work.

Software Development

Olakunlevpn Filament Skills

25

olakunlevpn/olakunlevpn-filament-skills

Use when writing, reviewing, or refactoring Filament PHP v5 code -- resources, forms, tables, infolists, actions, widgets, panels, relation managers, multi-tenancy, testing, or plugin development. Always apply these standards to all Filament work.

Software Development

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.