claude-code-skills icon indicating copy to clipboard operation
claude-code-skills copied to clipboard

Greate Claude Code skills collection. Production-ready skills that cover the full delivery workflow — from research and discovery to epic planning, task breakdown, implementation, testing, code review...

👋 Welcome to Claude Code Skills Repository

A comprehensive collection of skills for Claude Code, providing end-to-end Agile workflow automation integrated with Linear for modern software development teams.

Version Skills Updated License GitHub stars


📖 About

This repository contains 84 production-ready skills for Claude Code that automate and streamline your entire software development lifecycle. From project bootstrapping to documentation, story execution, and quality assurance, these skills work together to create a complete Agile development workflow.

What You Get:

  • 🎯 Complete Agile Workflow - From Epic decomposition to task execution and review
  • 📋 Linear Integration - Seamless task management and tracking
  • 🔄 Automated Workflows - Intelligent orchestration of development tasks
  • 📊 Visual Documentation - Mermaid diagrams for every skill workflow
  • 🏗️ Best Practices Built-In - KISS/YAGNI/DRY principles, Risk-Based Testing, Industry Standards compliance

Perfect For:

  • Software development teams using Agile methodologies
  • Projects integrated with Linear for task management
  • Teams seeking to automate repetitive development workflows
  • Organizations wanting to standardize their development practices

🚀 Features

0. Shared & Research Workers (0XX)

Universal research workers for standards, best practices, and architectural patterns. Used across Planning, Task Management, and Quality workflows.

Skill Purpose Version Diagrams
ln-001-standards-researcher Research industry standards, RFCs, and architectural patterns via MCP Context7 + MCP Ref. Generates Standards Research (Markdown format) for insertion in Story Technical Notes → Library Research subsection. Reusable worker (called by ln-220 Phase 2). Libraries researched at Task level by ln-300. Time-boxed: 15-20 minutes. 3.0.0
ln-002-best-practices-researcher Research best practices via MCP Ref/Context7 and create documentation (guide/manual/ADR). Single research, multiple output types. Reusable worker (called by ln-310, ln-620). 3.0.0

1. Documentation System (1XX)

ln-100-documents-pipeline (L1 Top Orchestrator) manages complete documentation lifecycle with 3-tier architecture and global cleanup (Phase 4).

L1 Top Orchestrator:

Skill Purpose Version Diagrams
ln-100-documents-pipeline L1 Top Orchestrator that creates complete documentation system in one command. Invokes L2 coordinator (ln-110) + 4 L2 workers (ln-120-150). Phase 4: Global cleanup (deduplication, orphaned files, consolidation, cross-links). Idempotent: Pre-flight check shows existing/missing files. 3.0.0

L2 Coordinator (Project Documentation):

Skill Purpose Version Diagrams
ln-110-project-docs-coordinator L2 Coordinator that gathers context ONCE, detects project type (hasBackend, hasFrontend, hasDatabase, hasDocker), delegates to 5 L3 workers. Solves "context loss" problem by passing Context Store explicitly. 3.0.0

L3 Workers (Project Documentation - under ln-110):

Skill Purpose Version Diagrams
ln-111-root-docs-creator Create 4 root docs: CLAUDE.md, docs/README.md, documentation_standards.md, principles.md. ALWAYS invoked. 3.0.0
ln-112-project-core-creator Create 3 core project docs: requirements.md, architecture.md, tech_stack.md. ALWAYS invoked. High auto-discovery. 3.0.0
ln-113-backend-docs-creator Create 2 conditional docs: api_spec.md (if hasBackend), database_schema.md (if hasDatabase). 3.0.0
ln-114-frontend-docs-creator Create 1 conditional doc: design_guidelines.md (if hasFrontend). WCAG 2.1 compliant. 3.0.0
ln-115-devops-docs-creator Create 1 conditional doc: runbook.md (if hasDocker). Operations guide. 3.0.0

L2 Workers (Other Documentation):

Skill Purpose Version Diagrams
ln-120-reference-docs-creator Create reference documentation structure: docs/reference/README.md + adrs/, guides/, manuals/ directories. Idempotent: Checks 4 items. 3.0.0
ln-130-tasks-docs-creator Create task management documentation: docs/tasks/README.md (task system rules) + kanban_board.md (Linear integration). Idempotent: Critical kanban_board.md protection. 3.0.0
ln-140-test-docs-creator Create test documentation: testing-strategy.md (universal testing philosophy) + tests/README.md (organization with Story-Level Pattern). Optional. Idempotent: Checks 4 items. 3.0.0
ln-150-presentation-creator Build interactive HTML presentation from project documentation with 6 tabs (Overview, Requirements+ADRs, Architecture, Technical Spec, Roadmap, Guides). Idempotent: User confirmation for rebuild. 3.0.0

2. Planning (2XX)

Orchestrator-Worker Pattern applied to decomposition workflow. ln-200-scope-decomposer (TOP orchestrator) automates full decomposition (scope → Epics → Stories) by delegating to ln-210-epic-coordinator (CREATE/REPLAN Epics) → ln-220-story-coordinator (CREATE/REPLAN Stories with Phase 2 standards research via ln-001-standards-researcher) → ln-230-story-prioritizer (RICE prioritization per Story with market research).

Orchestrator:

Skill Purpose Version Diagrams
ln-200-scope-decomposer TOP Orchestrator for full decomposition automation (scope → Epics → Stories). Sequentially delegates: ln-210-epic-coordinator (Phase 2) → ln-220-story-coordinator loop per Epic (Phase 3). User confirmation required (Phase 1). Provides summary + next steps (Phase 4). 3.0.0

Coordinators:

Skill Purpose Version Diagrams
ln-210-epic-coordinator Domain Coordinator that decomposes scope into 3-7 Linear Projects (Epics) with business goals, success criteria, and phased strategy. Decompose-First Pattern: builds IDEAL plan → checks existing → CREATE/REPLAN mode (KEEP/UPDATE/OBSOLETE/CREATE). Auto-discovers team ID. 3.0.0
ln-220-story-coordinator Coordinator for Story operations. Context Assembly (Phase 1: Epic extraction, frontend research, fallback search) → Standards Research (Phase 2: delegates ln-001-standards-researcher) → IDEAL Planning (Phase 3: 5-10 Stories, INVEST validation) → Mode Determination (Phase 4: count existing) → Delegates CREATE (ln-221-story-creator) or REPLAN (ln-222-story-replanner). Token efficiency: metadata-only loading (ID/title/status ~50 tokens/Story), workers load full descriptions (~5,000 tokens) when needed. 3.0.0

Workers (CREATE/REPLAN path - ln-220):

Skill Purpose Version Diagrams
ln-221-story-creator Creates Stories from IDEAL plan (ln-220 Phase 5a). Generates 8-section documents with Standards Research insertion (Technical Notes), validates INVEST criteria, shows preview, creates in Linear (project=Epic, labels=user-story, state=Backlog), updates kanban_board.md via Epic Grouping Algorithm. First-time Epic decomposition. Owns story_template_universal.md. 3.0.0
ln-222-story-replanner Replans Stories when Epic requirements change (ln-220 Phase 5b). Progressive Loading (ONE BY ONE for token efficiency: ~5,000 tokens/Story), compares IDEAL vs existing, categorizes operations (KEEP/UPDATE/OBSOLETE/CREATE), shows diffs (AC, Standards Research, Technical Notes), user confirmation, executes updates (respects status constraints: Backlog/Todo only), updates kanban_board.md. Story Split/Merge detection. 3.0.0

Story Prioritization (after ln-220):

Skill Purpose Version Diagrams
ln-230-story-prioritizer L2 Worker for Story-level RICE prioritization after ln-220. Loads Stories from Epic, researches market size and competition per Story via WebSearch/Ref, calculates RICE score (Reach × Impact × Confidence / Effort), assigns Priority (P0-P3) with Competition Index (Blue 1-2 / Red 4-5). Generates consolidated table in docs/market/[epic-slug]/prioritization.md. Time-boxed: 40-60 minutes. 3.0.0

3. Task Management (3XX)

Task planning and Story validation workflows. ln-300-task-coordinator decomposes Stories into 1-6 implementation tasks. ln-310-story-validator validates Stories/Tasks against 2025 standards (CRITICAL PATH FIRST) with auto-fixes and research via ln-002-best-practices-researcher.

Coordinators:

Skill Purpose Version Diagrams
ln-300-task-coordinator Coordinator for task operations. Analyzes Story, builds optimal task plan (1-6 tasks, Foundation-First execution order), delegates to ln-301-task-creator (CREATE) or ln-302-task-replanner (REPLAN) with taskType: "implementation". Auto-discovers team ID. For implementation tasks only. 3.0.0
ln-310-story-validator Coordinator that validates Stories/Tasks against 2025 standards - CRITICAL PATH FIRST. Phase 2: Research via ln-002 (domain extraction, TRIVIAL CRUD detection). Phase 3: Decision Point (REPLAN ≥50% improvement OR CONTINUE). Phase 4: Auto-fixes 17 criteria (Progressive Disclosure: 5 validation files). No direct MCP calls. Tabular output (Unicode box-drawing). Upstream validation (ln-220). No "Needs Work" path exists. 3.0.0

Workers (CREATE/REPLAN path - ln-300):

Skill Purpose Version Diagrams
ln-301-task-creator Universal factory for creating ALL 3 task types (implementation, refactoring, test). Generates task documents from templates, validates type-specific rules, creates in Linear. DRY Check: Scans codebase (Grep) for similar functionality, adds warnings to Task descriptions with reuse/extend/justify recommendations (≥70% similarity). Invoked by orchestrators (ln-300-task-coordinator, ln-500-story-quality-gate, ln-510-test-planner). Owns all 3 templates. 3.0.0
ln-302-task-replanner Universal replanner for updating ALL 3 task types (implementation, refactoring, test). Compares IDEAL plan vs existing, categorizes operations (KEEP/UPDATE/OBSOLETE/CREATE), applies type-specific validation, executes changes in Linear. Reads templates from ln-301-task-creator/references/. 3.0.0

4. Execution (4XX)

ln-400-story-executor (Orchestrator) automates complete Story workflow with priority-based task execution (To Review → To Rework → Todo) and automatic quality gates delegation.

Orchestrator:

Skill Purpose Version Diagrams
ln-400-story-executor Orchestrator that orchestrates Story execution (Todo → In Progress → To Review → Done). Priority 0: Backlog (auto-verify new tasks before execution) → Priority 1: To ReviewPriority 2: To ReworkPriority 3: Todo. Auto-invokes ln-500-story-quality-gate Pass 1 + Pass 2 (full automation). Phase 4 delegates Story quality to ln-500-story-quality-gate (Orchestrator-Worker Pattern). 3.0.0

Workers (Task Execution):

Skill Purpose Version Diagrams
ln-401-task-executor Execute implementation tasks ONLY (Todo → In Progress → To Review). Uses KISS/YAGNI principles, reads guide links, runs type checking and linting. Story status management removed (now ln-400-story-executor's responsibility). NOT for test tasks. 3.0.0
ln-402-task-reviewer Review completed tasks for To Review → Done/Rework transition. Distinguishes test/implementation tasks. Checks architecture, docs, security, quality, and test coverage. 3.0.0
ln-403-task-rework Fix tasks marked To Rework. Analyzes feedback, applies fixes following KISS/YAGNI/DRY principles, runs quality gates (type checking, linting), and submits back To Review. 3.0.0
ln-404-test-executor Execute Story Finalizer test tasks (Todo → In Progress → To Review). E2E-first Risk-Based Testing (2-5 E2E, 3-8 Integration, 5-15 Unit). Includes test fixes, infrastructure, docs, and legacy cleanup. 3.0.0

5. Quality (5XX)

ln-500-story-quality-gate (Coordinator) validates Story quality with Pass 1 (code quality, regression, manual AC) and Pass 2 (automated tests). ln-510-test-planner creates comprehensive test tasks after manual testing passes.

Quality Gate (Coordinator):

Skill Purpose Version Diagrams
ln-500-story-quality-gate Coordinator for Story quality. Pass 1 delegates code analysis to ln-501-code-quality-checker, regression to ln-502-regression-checker, manual AC verification to ln-503-manual-tester (Format v1.0) with FAIL-FAST exit at each gate; auto-creates refactor/bug tasks when any gate fails. When all gates pass, automatically runs ln-510-test-planner (autoApprove: true) to create Story Finalizer test task. Pass 2 verifies automated tests (Priority >=15, limits 10-28) and moves Story to Done. 3.0.0

Workers (Pass 1 Validation):

Skill Purpose Version Diagrams
ln-501-code-quality-checker Analyze code quality for DRY/KISS/YAGNI/Architecture violations and guide compliance. Checks git diffs of Done implementation tasks. Reports structured issues by severity (HIGH/MEDIUM/LOW). Fail Fast principle - runs FIRST in Phase 4. 3.0.0
ln-502-regression-checker Run existing test suite to verify no regressions. Auto-detects framework (pytest/jest/vitest/go test). Returns JSON verdict + Linear comment. Atomic worker - does NOT create tasks or change statuses. 3.0.0
ln-503-manual-tester Perform manual functional testing of Story AC using curl (API) or puppeteer (UI). Tests main scenarios + edge cases + error handling + integration. Creates reusable temp script scripts/tmp_[story_id].sh. Documents results in Linear (Format v1.0). 3.0.0

Test Planning:

Skill Purpose Version Diagrams
ln-510-test-planner Coordinator that creates test task for Story after manual testing passes. Analyzes Story, generates comprehensive test task with 11 sections. Delegates to ln-301-task-creator (CREATE) or ln-302-task-replanner (REPLAN) with taskType: "test". Supports existing test task updates. Uses 3XX workers for task creation/replanning. 3.0.0

6. Audit (6XX)

Comprehensive audit system for documentation, code comments, codebase quality, and test suites. All coordinators research best practices ONCE and delegate to specialized workers IN PARALLEL.

Documentation & Comments Audit:

Skill Purpose Version Diagrams
ln-600-docs-auditor Audit documentation quality across 6 categories (Hierarchy, SSOT, Compactness, Requirements, Actuality, Legacy). Outputs Compliance Score X/10 + Findings. User-invocable or part of ln-100 pipeline. 3.0.0
ln-610-code-comments-auditor Audit code comments and docstrings across 6 categories (WHY-not-WHAT, Density, Forbidden, Docstrings, Actuality, Legacy). Universal for any tech stack. 3.0.0

Codebase Quality Audit:

Skill Purpose Version Diagrams
ln-620-codebase-auditor L2 Coordinator that orchestrates complete codebase quality audit. Researches best practices ONCE, delegates to 9 specialized workers IN PARALLEL, aggregates results into single consolidated report. Creates refactoring task in Linear Epic 0. Manual invocation for technical debt assessment. 3.0.0

Workers (L3 Codebase Audit Specialists):

# Skill Priority What It Audits Version
1 ln-621-security-auditor CRITICAL Hardcoded secrets, SQL injection, XSS, insecure dependencies, missing input validation 3.0.0
2 ln-622-build-auditor CRITICAL Compiler/linter errors, deprecation warnings, type errors, failed tests, build config 3.0.0
3 ln-623-architecture-auditor HIGH DRY/KISS/YAGNI violations, layer breaks, TODO/FIXME, workarounds, error handling 3.0.0
4 ln-624-code-quality-auditor MEDIUM Cyclomatic complexity, O(n²), N+1 queries, magic numbers, duplicate constants 3.0.0
5 ln-625-dependencies-auditor MEDIUM Outdated packages, unused dependencies, reinvented wheels, custom implementations 3.0.0
6 ln-626-dead-code-auditor LOW Unreachable code, unused imports/variables/functions, commented-out code 3.0.0
7 ln-627-observability-auditor MEDIUM Structured logging, health checks, metrics, request tracing, log levels 3.0.0
8 ln-628-concurrency-auditor HIGH Race conditions, async/await, resource contention, thread safety, deadlocks 3.0.0
9 ln-629-lifecycle-auditor MEDIUM Bootstrap, graceful shutdown, resource cleanup, signal handling, probes 3.0.0

Test Suite Audit:

Skill Purpose Version Diagrams
ln-630-test-auditor L2 Coordinator that orchestrates comprehensive test suite audit. Researches testing best practices ONCE, delegates to 5 specialized workers IN PARALLEL, aggregates results into unified audit report with KEEP/REMOVE/REVIEW decisions. Calculates Usefulness Score per test (Impact × Probability). Creates refactoring task in Linear Epic 0. Manual invocation for test suite quality assessment. 3.0.0

Workers (L3 Test Audit Specialists):

# Skill Category What It Audits Version
1 ln-631-test-business-logic-auditor Business Logic Focus Framework/library tests (Prisma, Express, bcrypt, JWT, axios, React hooks) → REMOVE 3.0.0
2 ln-632-test-e2e-priority-auditor E2E Priority E2E baseline (2/endpoint: positive + negative), pyramid validation, missing E2E tests 3.0.0
3 ln-633-test-value-auditor Risk-Based Value Usefulness Score = Impact (1-5) × Probability (1-5). Thresholds: ≥15 KEEP, 10-14 REVIEW, <10 REMOVE 3.0.0
4 ln-634-test-coverage-auditor Coverage Gaps Missing tests for critical paths (Money 20+, Security 20+, Data 15+, Core Flows 15+) 3.0.0
5 ln-635-test-isolation-auditor Isolation + Anti-Patterns Isolation (APIs, DB, FS, Time, Random, Network), Anti-Patterns (Liar, Giant, Slow Poke, Conjoined Twins, Happy Path Only, Framework Tester) 3.0.0

7. Project Bootstrap (7XX)

Technology-agnostic project bootstrap system that automates migration from prototypes to production-ready repositories. Supports React/Vue/Angular frontends, .NET/Node/Python backends.

L1 Top Orchestrator:

Skill Purpose Version Diagrams
ln-700-project-bootstrap L1 Top Orchestrator for full project bootstrap. Detects tech stack, generates transformation plan, delegates to 8 L2 coordinators in sequence. Handles: dependencies → structure → devops → quality → commands → security → crosscutting → verification. 1.0.0

L2 Coordinators (Domain-Specific):

Skill Purpose Version Diagrams
ln-710-dependency-upgrader Upgrade all dependencies to latest versions. Detects npm/nuget/pip, delegates to L3 workers, handles breaking changes. 1.0.0
ln-720-structure-migrator Restructure project to Clean Architecture. Moves frontend to src/frontend/, generates .NET backend structure. 1.0.0
ln-730-devops-setup Setup Docker, CI/CD, and environment configuration. Multi-stage builds, GitHub Actions workflows. 1.0.0
ln-740-quality-setup Configure linters, pre-commit hooks, and test infrastructure. ESLint flat config, Husky, Vitest/xUnit. 1.0.0
ln-750-commands-generator Generate project-specific .claude/commands. refresh_context, refresh_infrastructure, build-and-test. 1.0.0
ln-760-security-setup Setup security scanning and secret detection. Dependency audit, SECURITY.md generation. 1.0.0
ln-770-crosscutting-setup Configure logging, error handling, CORS, health checks, and Swagger. Serilog/Pino, GlobalExceptionMiddleware. 1.0.0
ln-780-bootstrap-verifier Final verification: build, test, and run in Docker. Health checks, container launch, full report. 1.0.0

L3 Workers (Dependency Upgrader - ln-710):

Skill Purpose Version
ln-711-npm-upgrader Upgrade npm/yarn/pnpm packages with breaking change handling 1.0.0
ln-712-nuget-upgrader Upgrade .NET NuGet packages 1.0.0
ln-713-pip-upgrader Upgrade Python pip/poetry packages 1.0.0

L3 Workers (Structure Migrator - ln-720):

Skill Purpose Version
ln-721-frontend-restructure Restructure frontend to component-based architecture 1.0.0
ln-722-backend-generator Generate .NET Clean Architecture backend 1.0.0
ln-723-mockdata-migrator Migrate Drizzle/Prisma schema to C# MockData 1.0.0
ln-724-replit-cleaner Remove all Replit artifacts (configs, packages, code comments, directories) 1.0.0

L3 Workers (DevOps Setup - ln-730):

Skill Purpose Version
ln-731-docker-generator Generate Dockerfiles and docker-compose.yml 1.0.0
ln-732-cicd-generator Generate GitHub Actions / Azure Pipelines 1.0.0
ln-733-env-configurator Configure .env.example and environment variables 1.0.0

L3 Workers (Quality Setup - ln-740):

Skill Purpose Version
ln-741-linter-configurator Configure ESLint, Prettier, .editorconfig 1.0.0
ln-742-precommit-setup Setup Husky, lint-staged, commitlint 1.0.0
ln-743-test-infrastructure Setup Vitest/Jest, xUnit test infrastructure 1.0.0

L3 Workers (Commands Generator - ln-750):

Skill Purpose Version
ln-751-command-templates Generate command files from templates 1.0.0

L3 Workers (Security Setup - ln-760):

Skill Purpose Version
ln-761-secret-scanner Detect hardcoded secrets and API keys 1.0.0
ln-762-dependency-audit Run npm audit / dotnet vulnerable / pip-audit 1.0.0

L3 Workers (Crosscutting Setup - ln-770):

Skill Purpose Version
ln-771-logging-configurator Configure Serilog (.NET) / Pino (Node) / structlog (Python) 1.0.0
ln-772-error-handler-setup Setup GlobalExceptionMiddleware, ErrorBoundary 1.0.0
ln-773-cors-configurator Configure CORS policy for dev/prod 1.0.0
ln-774-healthcheck-setup Setup /health, /health/ready, /health/live endpoints 1.0.0
ln-775-api-docs-generator Configure Swagger/OpenAPI documentation 1.0.0

L3 Workers (Bootstrap Verifier - ln-780):

Skill Purpose Version
ln-781-build-verifier Verify builds for all project components 1.0.0
ln-782-test-runner Run all test suites and report results 1.0.0
ln-783-container-launcher Launch Docker containers with health checks 1.0.0

📥 Installation

Available Plugin

Plugin Skills Use Case Dependencies
full-development-workflow-skills 84 Complete Agile workflow (bootstrap + docs + planning + execution + quality + audit) Linear + Context7 + Ref

Installation Methods

Prerequisites: Claude Code CLI installed

Choose your installation method:

Method 1: Plugin Marketplace (Recommended)

/plugin marketplace add levnikolaevich/claude-code-skills

# Install the plugin (84 skills)
/plugin install full-development-workflow-skills@levnikolaevich-skills-marketplace

# Verify installation
/skills

Method 2: Direct Plugin

/plugin add levnikolaevich/claude-code-skills
/skills  # Verify installation

Method 3: Git Clone

# macOS/Linux
git clone https://github.com/levnikolaevich/claude-code-skills.git ~/.claude/skills

# Windows
git clone https://github.com/levnikolaevich/claude-code-skills.git %USERPROFILE%\.claude\skills

# Verify
/skills

📖 For detailed setup, updates, and configuration, see Advanced Setup section below.


📊 Visual Documentation

Every skill includes workflow diagrams (diagram.html) that visualize execution flow, decision points, and state transitions. Diagrams use Mermaid format and work locally without any server setup.


💡 Usage

Quick Start Example

Creating Project Documentation:

# In Claude Code, invoke the skill
ln-100-documents-pipeline
# Follow the interactive prompts to generate comprehensive documentation

Decomposing Epic into Stories:

# Invoke story coordinator with Epic number
ln-220-story-coordinator
# Skill will analyze Epic and create/replan Stories automatically

Executing a Story:

# Invoke story executor with Story ID
ln-330-story-executor
# Skill will orchestrate task execution, reviews, and rework

Typical Workflow

Automated Workflow:

0. ln-700-project-bootstrap  → Bootstrap project (deps → structure → devops → quality → Docker)
1. ln-100-documents-pipeline → Create project documentation
2. ln-210-epic-coordinator   → Decompose scope into Epics
3. ln-220-story-coordinator  → Create Stories for an Epic (with library research)
4. ln-400-story-executor     → Complete automation from task planning to Done
   └─ Orchestrates: task execution → review → rework → quality gates

For manual step-by-step workflow and detailed usage, see CLAUDE.md.


🔧 Advanced Setup

Prerequisites

Before installation, ensure you have:

  • Claude Code CLI - Install from claude.ai/code
  • Git - Required for Method 3 (Git Clone) installation
  • Linear Account (optional) - For task management integration features
    • Create API key at linear.app/settings/api
    • Configure team ID in docs/tasks/kanban_board.md (auto-generated by ln-130-tasks-docs-creator)

Updating

For Plugin installations (Method 1 or 2):

/plugin update full-development-workflow-skills

For Git Clone installation (Method 3):

# Navigate to skills directory
cd ~/.claude/skills                    # macOS/Linux
cd %USERPROFILE%\.claude\skills       # Windows CMD
cd $env:USERPROFILE\.claude\skills    # Windows PowerShell

# Pull latest changes
git pull origin master

Configuration

Linear Integration (Optional): Skills auto-discover configuration from docs/tasks/kanban_board.md (Team ID, Epic/Story numbers). Run ln-130-tasks-docs-creator to generate config file. No setup required - skills work independently.


🤝 Contributing

We warmly welcome contributions! 🎉

Whether you're fixing bugs, improving documentation, adding features, or creating new skills - your contributions make this project better for everyone.

How to contribute:

  • Fork → Create feature branch → Submit PR
  • Bug fixes, documentation improvements, new skills, translations

See CONTRIBUTING.md for detailed guidelines.


📚 Documentation

Core Documentation

  • CLAUDE.md - Comprehensive guide with:
    • Repository structure and skill organization
    • Task hierarchy (Epic → Story → Task)
    • Development principles (KISS/YAGNI/DRY, Standards First, Risk-Based Testing)
    • Complete workflow documentation for all skills
    • Template references and best practices
    • Linear integration details

Skill Structure

Each skill follows a unified structure:

x-skill-name/
├── SKILL.md              # Metadata and full description
├── diagram.html          # Standalone HTML with embedded Mermaid diagram
└── references/           # Templates and guides
    ├── template.md       # Document templates
    └── guide.md          # Reference guides

shared/
└── css/
    └── diagram.css       # Universal CSS for all diagrams

Template Ownership Principle

  • Each skill owns its templates in its own references/ directory (Single Source of Truth)
  • Templates are NOT copied to project during setup
  • Skills use templates directly from their references/ when generating documents
  • Example: ln-321-best-practices-researcher uses ln-321-best-practices-researcher/references/adr_template.md when creating ADRs

🌟 Key Concepts

Task Hierarchy

Epic (Linear Project)
  └── User Story (Linear Issue with label "user-story")
      └── Task (Linear Issue with parentId=Story ID)
          └── Subtask (implementation steps)

Development Principles

Hierarchy of Principles (when conflicts arise):

  1. Industry Standards & RFCs (OAuth 2.0, REST API design, OpenAPI, protocol standards)
  2. Security Standards (OWASP Top 10, NIST guidelines)
  3. Development Principles (KISS/YAGNI/DRY apply WITHIN standard boundaries)

Core Principles:

  • Standards First - Follow industry standards before applying KISS/YAGNI
  • YAGNI - Do not add functionality ahead of time
  • KISS - Simplest solution that works (within standard boundaries)
  • DRY - Do not duplicate code
  • Consumer-First Design - Design APIs/interfaces from consumer perspective (what they need first)
  • Foundation-First Execution - Build from foundation up (Database → Repository → Service → API) for testability
  • Task Granularity - Optimal task size 3-5 hours (max 6 tasks per Story)
  • Value-Based Testing - Prioritize by business risk (2-5 E2E, 3-8 Integration, 5-15 Unit per Story)
  • No Legacy Code - Remove backward compatibility shims and deprecated patterns

📄 License

This project is licensed under the MIT License - see the repository for details.

Feel free to use, modify, and distribute this software in your projects!


🙏 Acknowledgments

  • Claude Code Team - For creating an amazing AI-powered development environment
  • Linear Team - For excellent task management and API
  • Mermaid.js - For beautiful, git-friendly diagrams
  • Community Contributors - Thank you for making this project better!

👤 Author

Lev Nikolaevich


📬 Questions or Feedback?

  • 💬 Discussions - Share ideas and ask questions in GitHub Discussions
  • 🐛 Issues - Report bugs or request features via GitHub Issues
  • Star this repo - If you find it useful!

Happy Coding! 🚀

Built with ❤️ by the community, for the community