technical-spec SKILL.md skillA

technical-spec from shinpr/ai-coding-project-boilerplate is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add shinpr/ai-coding-project-boilerplate/technical-spec@git:20260923.03f66be

Pins git:20260923.03f66be in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
shinpr/ai-coding-project-boilerplate
Path
.claude/skills-en/technical-spec/SKILL.md
Versions recorded
5
Latest version
git:20260923.03f66be, committed Sep 23, 2026
First version recorded
Jul 19, 2026
Size
5,808 bytes
Repository stars
234
License
MIT

Defines environment variables, architecture design, and build/test commands. Use when configuring environment or designing architecture.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Technical Design Rules

## Prerequisite Detection

Inspect manifests, lockfiles, build/test configuration, CI definitions, and representative source files before applying a technology- or command-specific rule. Treat a tool, script, path alias, or runtime as observed only when repository evidence names it. Label conclusions from surrounding patterns as inferred. When a missing decision changes architecture, compatibility, security, or verification, stop and name the exact configuration or user decision required.

## Basic Technology Stack Policy
These rules apply to a TypeScript application when repository configuration confirms that stack. Select architecture by mapping current requirements and accepted constraints to explicit module responsibilities, dependency direction, data flow, and verification boundaries.

## Environment Variable Management and Security

### Environment Variable Management
- Centrally manage environment variables and the build-time validation mechanism that enforces their type safety
- Read environment variables through one typed configuration boundary; application code consumes validated configuration values
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add shinpr/ai-coding-project-boilerplate/technical-spec@sha256:b74fbf600cf8450c

The line at the top of this page pins the label git:20260923.03f66be, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ivgwxn7dphx4h34f.svg)](https://markdownregistry.com/a/art_ivgwxn7dphx4h34f)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Jul 19, 2026 and Sep 23, 2026, about one every 16 days.

versioncommittedcommitsizeaudit
git:20260923.03f66be latest2026-09-23 03f66be 5,808 BA view · diff
git:20260831.b1830372026-08-31 b183037 5,752 BA view · diff
git:20260818.2a2fe8e2026-08-18 2a2fe8e 5,862 BA view · diff
git:20260805.abe80f12026-08-05 abe80f1 6,501 BA view · diff
git:20260719.191ec132026-07-19 191ec13 6,560 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (5808 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

shinpr/ai-coding-project-boilerplate · 234 stars · license MIT · pushed 2026-10-14 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ivgwxn7dphx4h34f
GET https://markdownregistry.com/api/v1/resolve?ref=shinpr/ai-coding-project-boilerplate/technical-spec
GET https://markdownregistry.com/api/v1/blob/b74fbf600cf8450c8f165dbe21137b2cd72a689eeeb4470d8f8fa0037f16cea0

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from shinpr/ai-coding-project-boilerplate

coding-standards SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-en/coding-standards/SKILL.md · Detects code smells, anti-patterns, and readability issues. Use when implementing features, reviewing code, or…
git:20261014.578fed5 · audit A · 234 stars
documentation-criteria SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-en/documentation-criteria/SKILL.md · Determines which PRD, ADR, UI Spec, Design Doc, and Work Plan a change requires and where each is stored. Use when…
git:20260923.86a3d79 · audit A · 234 stars
frontend-technical-spec SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-en/frontend-technical-spec/SKILL.md · Defines React environment, component architecture, state/data flow, build verification, and frontend non-functional…
git:20260923.03f66be · audit A · 234 stars
frontend-typescript-rules SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-en/frontend-typescript-rules/SKILL.md · Applies React/TypeScript type safety, component design, and state management rules. Use when implementing React…
git:20260912.c0d4362 · audit A · 234 stars
frontend-typescript-testing SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-en/frontend-typescript-testing/SKILL.md · Designs frontend tests using the repository's configured React test and browser harnesses, including RTL, MSW, Vitest…
git:20261014.578fed5 · audit A · 234 stars
implementation-approach SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-en/implementation-approach/SKILL.md · Selects implementation strategy (vertical slice, horizontal, or hybrid) with risk assessment. Use when planning feature…
git:20261014.578fed5 · audit A · 234 stars
integration-e2e-testing SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-en/integration-e2e-testing/SKILL.md · Selects and designs the smallest integration/E2E test set that proves accepted behavior at an observable boundary. Use…
git:20261014.578fed5 · audit A · 234 stars
llm-friendly-context SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-en/llm-friendly-context/SKILL.md · Clarifies inputs, outputs, success criteria, decisions, and unresolved conditions so downstream agents can execute…
git:20260923.86a3d79 · audit A · 234 stars
project-context SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-en/project-context/SKILL.md · Marks project context as unconfigured until domain constraints, repository quality standards, phase, conventions, and…
git:20260901.b347ae2 · audit A · 234 stars
requirement-convergence SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-en/requirement-convergence/SKILL.md · Separates the outcome a change must produce from the requirements proposed to reach it, records what the user excluded…
git:20260923.558b381 · audit A · 234 stars
skill-optimization SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-en/skill-optimization/SKILL.md · Evaluates and optimizes skill file quality using 9 content patterns and 10 editing principles. Use when creating…
git:20260831.b183037 · audit A · 234 stars
subagents-orchestration-guide SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-en/subagents-orchestration-guide/SKILL.md · Coordinates subagents through scale-based planning, approval, implementation, verification, and escalation flows. Use…
git:20261003.24e6460 · audit A · 234 stars

Every file in shinpr/ai-coding-project-boilerplate

Other files named technical-spec

technical-spec SKILL.md skill
majiayu000/spellbook · skills/technical-spec/SKILL.md · Technical specification and design document expert. Use when writing design docs, RFCs, ADRs, or evaluating technology…
git:20260523.d39dd11 · audit A · 288 stars
technical-spec SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-zh-CN/technical-spec/SKILL.md · 定义环境变量、架构设计以及构建/测试命令。在配置环境或设计架构时使用。
git:20260923.03f66be · audit A · 234 stars
technical-spec SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-ja/technical-spec/SKILL.md · 環境変数、アーキテクチャ設計、ビルド・テストコマンドを定義。環境設定、アーキテクチャ設計時に使用。
git:20260923.03f66be · audit A · 234 stars

Browse by kind, by grade A, or by owner.