Agent Skill
2/7/2026

applying-solid-principles

Applies SOLID principles and clean code practices. Required for all code implementations - automatically reference when writing or reviewing any code. Covers single responsibility, open-closed, Liskov substitution, interface segregation, and dependency inversion principles.

S
sumik5
1GitHub Stars
1Views
npx skills add sumik5/sumik-claude-plugin

SKILL.md

Nameapplying-solid-principles
DescriptionApplies SOLID principles and clean code practices. Required for all code implementations - automatically reference when writing or reviewing any code. Covers single responsibility, open-closed, Liskov substitution, interface segregation, and dependency inversion principles.

sumik-claude-plugin

Claude Codeの開発ワークフローを強化する包括的なプラグインシステム


概要

Claude Codeの開発効率を最大化するためのプラグイン。Agent、コマンド、スキル、フック、MCPサーバー統合を含み、並列実行モデル、トークン効率化、型安全性、セキュリティファーストのアプローチを実現します。


インストール

claude plugin add sumik5/sumik-claude-plugin

ディレクトリ構成

sumik-claude-plugin/
├── .claude-plugin/     # プラグインマニフェスト
│   ├── plugin.json     # プラグインメタデータ
│   └── marketplace.json
├── .mcp.json           # MCPサーバー設定
├── agents/             # Agent定義 (23体)
├── commands/           # スラッシュコマンド (11個)
├── hooks/              # イベントフック (4個)
├── scripts/            # ヘルパースクリプト (3個)
└── skills/             # ナレッジスキル (93個)

コンポーネント一覧

Agents (23体)

Agentモデル説明
タチコマ (tachikoma)Sonnet汎用実行Agent。専門タチコマでカバーされないタスクや複数ドメイン横断タスクを担当。並列実行対応(1-4体)
Serena Expert (serena-expert)Sonnet/serenaコマンドを活用したトークン効率重視の開発Agent
タチコマ(Next.js) (tachikoma-nextjs)SonnetNext.js 16/React 19専門。App Router・Server Components・Turbopack・next-devtools統合
タチコマ(デザイン) (tachikoma-design)Sonnetデザイン専門。Figma MCP全13ツール活用・デザインシステム構築/運用・Tailwind CSSスタイリング・UI/UXデザイン原則・デザイントークン同期
タチコマ(フロントエンド) (tachikoma-frontend)Sonnetフロントエンドコンポーネント実装専門。shadcn/ui・Storybook(CSF3・インタラクションテスト・a11y)・データビジュアライゼーション
タチコマ(TypeScript) (tachikoma-typescript)SonnetTypeScript型システム専門。高度な型パターン・ジェネリクス・条件型・GoFデザインパターン
タチコマ(フルスタックJS) (tachikoma-fullstack-js)SonnetフルスタックJS専門。NestJS/Express・REST API設計・構造化ログ
タチコマ(Python) (tachikoma-python)SonnetPython専門。Python 3.13+・uv/ruff/mypy・FastAPI/FastMCP・Google ADKエージェント構築
タチコマ(Go) (tachikoma-go)SonnetGo専門。concurrencyパターン・インターフェース設計・エラーハンドリング・GoFパターン・Go内部構造
タチコマ(Bash) (tachikoma-bash)SonnetBashシェルスクリプト専門。strict mode・I/Oパイプライン・プロセス制御・セキュリティ・ShellCheck
タチコマ(アーキテクチャ) (tachikoma-architecture)Opusアーキテクチャ設計専門(読み取り専用)。DDD・マイクロサービス・トレードオフ分析。設計ドキュメント作成のみ
タチコマ(セキュリティ) (tachikoma-security)Opusセキュリティレビュー専門(読み取り専用)。OWASP・サーバーレスセキュリティ・IAM・動的認可。レポート作成のみ
タチコマ(オブザーバビリティ) (tachikoma-observability)Sonnetオブザーバビリティ専門。OpenTelemetry計装・SLO/SLI設計・アラート・ログパイプライン
タチコマ(ドキュメント) (tachikoma-document)Sonnetドキュメント作成専門。技術文書・LaTeX・Zenn記事・AIコピーライティング。コード実装なし
タチコマ(インフラ) (tachikoma-infra)Sonnetインフラ/DevOps専門。Docker・Compose・CI/CDパイプライン・Blue-Green/Canaryデプロイ
タチコマ(Terraform) (tachikoma-terraform)SonnetTerraform IaC専門。HCL・モジュール設計・state管理・Terragruntパターン・Terraform MCP活用
タチコマ(AWS) (tachikoma-aws)SonnetAWS専門。Lambda・API Gateway・DynamoDB・CDK・EKS・Bedrock・セキュリティ・FinOps
タチコマ(Google Cloud) (tachikoma-google-cloud)SonnetGoogle Cloud専門。Cloud Run・BigQuery・VPC・Memorystore・Zero Trust・データエンジニアリング
タチコマ(データベース) (tachikoma-database)Sonnetデータベース専門。リレーショナルDB設計・正規化・SQLアンチパターン回避・クエリ最適化・DB内部構造
タチコマ(AI/ML) (tachikoma-ai-ml)SonnetAI/ML開発専門。Vercel AI SDK・LangChain.js・RAGシステム・MCP開発・LLMOps運用
タチコマ(テスト) (tachikoma-test)Sonnetユニット/インテグレーションテスト専門。TDD・Vitest/Jest・React Testing Library・モック戦略
タチコマ(E2Eテスト) (tachikoma-e2e-test)SonnetE2Eテスト・ブラウザ自動化専門。Playwright Test・POM・ビジュアルテスト・アクセシビリティ・CI/CD統合
タチコマ(研修・プレゼン) (tachikoma-training-presenter)Sonnet研修設計・プレゼンテーション改善専門(自己進化型)。研修ニーズ分析・カリキュラム設計・プレゼン構成改善・デリバリー技法・文章品質向上

Commands (11個)

コマンド説明
/serenaトークン効率的な構造化開発
/serena-refreshSerena MCPデータ最新化
/reloadCLAUDE.md再読み込み(compaction後のコンテキスト復元)
/pull-requestPR説明文の自動生成
/git-tagアノテーション付きGitタグ作成
/changelogCHANGELOG自動生成(Keep a Changelog形式)
/commit-msg会話履歴とステージ済み変更からConventional Commitsコミットメッセージ生成
/generate-user-storyユーザーストーリー+E2Eテストドキュメント生成
/e2e-chrome-devtools-mcpChrome DevTools MCPによるE2Eテスト実行
/difitGitHub風差分ビューア(difit)でコードdiff表示
/react-doctorReact コード品質診断(react-doctor CLI、0-100スコア、セキュリティ・パフォーマンス・正確性)

Skills (95個)

コア開発

スキル説明
implementing-as-tachikomaタチコマAgent運用ガイド
using-serenaSerena MCP活用
writing-clean-code言語非依存のクリーンコードレシピ(SOLID原則・ソフトウェアデザインの法則含む25カテゴリのコードスメル検出・リファクタリング)
enforcing-type-safety型安全性強制(any禁止)
testing-codeテストファースト(Vitest/Playwright)。RTL固有はdeveloping-react参照
testing-web-apisWeb APIテスト戦略(設計テスト・探索テスト・コントラクトテスト・自動化・パフォーマンス・セキュリティ・本番モニタリング)
conducting-ab-testsA/Bテスト・オンラインコントロール実験(実験設計・統計分析・OEC・信用性検証・実験プラットフォーム・実験文化)
researching-librariesライブラリ調査(車輪の再発明禁止)
securing-codeセキュアコーディング(OWASP Top 10、インジェクション対策、認証・認可、Web penetration testing knowledge含む)
securing-serverlessサーバーレスセキュリティ包括ガイド(AWS Lambda・Google Cloud Run・Azure Functionsの攻撃・防御パターン、コード注入・SSRF・権限昇格・シークレット窃取、IAM最小権限、認証トークン管理、計7リファレンスファイル)
securing-ai-developmentAI開発セキュリティ戦略(信頼フレームワーク、適応型ガードレール、AI-BOM、AI-SPM、ガバナンス、クロスファンクショナル所有権)
developing-with-aiAI支援開発メソドロジー(プロンプトエンジニアリング・コンテキストエンジニアリング・コード生成・QA・デバッグ・エージェント協調)
using-claude-code-as-pmPM向けClaude Code活用ガイド(コードベース調査・バグトリアージ・競合分析・フィードバック分析・要件生成・PMワークフロー自動化)
applying-semantic-versioningSemVer 2.0.0仕様準拠バージョン判断ガイド(MAJOR/MINOR/PATCH判定・プレリリース・範囲指定・よくある誤り)
writing-conventional-commitsConventional Commits 1.0.0準拠コミットメッセージガイド(type/scope/BREAKING CHANGE判定・SemVer連携)
managing-claude-mdCLAUDE.md管理(8原則、プログレッシブ・ディスクロージャー、生きたドキュメント運用)
using-codexCodex CLI(OpenAI)連携(コード相談・レビュー・設計相談・バグ調査)
reviewing-plans-with-codexCodex CLI (gpt-5.3-codex) によるプランファイルレビュー(初回レビュー+resume再レビュー)
reviewing-codeコードレビュー方法論(PRの構成・効果的なコメント技法・TWA・アンチパターン対策)
converting-agents-to-codexClaude Code Agent定義(.md)をCodexマルチエージェント形式(config.toml + agent .toml)に変換。フォルダ指定で一括変換・差分更新対応

アーキテクチャ

スキル説明
applying-domain-driven-designDDD実践ガイド(戦略的設計・戦術的パターン・イベントストーミング・業務データ分解・ポリグロットDB選択)
modernizing-architectureSocio-technicalアーキテクチャモダナイゼーション(戦略・ドメイン設計・チーム組織・トレードオフ分析方法論)
designing-web-apisWeb API設計ベストプラクティス
developing-api-spec-firstAPI仕様ファースト開発方法論(仕様記述・E2Eテストフレームワーク・技術的負債返済・防御的プログラミング)
building-multi-tenant-saasマルチテナントSaaSアーキテクチャ設計ガイド
building-nextjs-saasNext.js AI SaaSアプリ構築パターン(認証・決済・AI API・クレジット課金)
implementing-dynamic-authorization動的認可設計(ABAC/ReBAC/PBAC、Cedar、認可アーキテクチャ)
architecting-microservicesマイクロサービスアーキテクチャパターン設計(CQRS・Event Sourcing・8種のSaga・分散トランザクション・サービス粒度・データ所有権・ワークフロー・コントラクト・メッセージング・レジリエンス・セキュリティ)
architecting-micro-frontendsマイクロフロントエンドアーキテクチャ(垂直/水平分割、Module Federation/iframe/Web Components/SSR/ESI構成パターン、意思決定フレームワーク、組織導入)
understanding-database-internalsデータベース内部構造の包括的リファレンス。ストレージエンジン(Bツリー、LSMツリー、トランザクション)、分散システム(合意アルゴリズム、レプリケーション、一貫性モデル)、DB選択・設計ガイドをカバー
avoiding-sql-antipatternsSQLアンチパターン回避(論理設計・物理設計・クエリ・アプリ開発の25パターン)
designing-relational-databasesリレーショナルDB設計ガイド(エンティティモデリング・ER図・正規化1NF-BCNF・インデックス・非正規化・PostgreSQL実装: マイクロサービスアーキテクチャ・ACID/トランザクション・関数/プロシージャ・AAAセキュリティ)
applying-behavior-design行動変容デザイン(CREATEファネル、3戦略)
building-green-softwareグリーンソフトウェアエンジニアリング(カーボン効率・運用効率・カーボンアウェアネス・測定方法論・GSMM・グリーンAI)
building-rag-systemsRAGシステム構築ガイド(11種データソース読み込み・5種チャンキング戦略・パイプラインアーキテクチャ・Python実装)
architecting-dataデータアーキテクチャパターン(Read-Side最適化、CQRS、CDC、Event Sourcing、キャッシュ戦略)
practicing-llmopsLLMOps運用フレームワーク(データ・モデル適応・API・評価・セキュリティ・スケーリング)
analyzing-software-tradeoffsソフトウェア設計トレードオフ分析(コードレベル: 重複・例外処理・柔軟性・最適化、API: 使いやすさ・バージョニング、分散システム: 一貫性・配信セマンティクス、メタ判断: ライブラリ選定・トレンド評価・日時データ・12リファレンスファイル)

フレームワーク

スキル説明
developing-reactReact 19.x 開発ガイド(Internals・パフォーマンスルール47+・アニメーション・RTLテスト)
remotion-best-practicesRemotion動画作成ベストプラクティス(React、Three.js、アニメーション、キャプション)
developing-nextjsNext.js 16.x開発ガイド(App Router・Server Components・Cache Components・Turbopack・実践パターン集)。Route Segment・Parallel/Intercepting Routes・Prisma・NextAuth.js・Server Actions・4種キャッシュ戦略を含む10リファレンスファイル。React固有はdeveloping-react参照
developing-goGo開発包括ガイド(クリーンコード・デザインパターン・並行処理詳細パターン・内部構造・スケジューラー・実践パターン7分野・nilハンドリング・テンプレートエンジン・34リファレンスファイル)
developing-pythonPython 3.13開発(Effective Python 125項目・実践パターン50問・SEプロセス: SDLC/方法論/システムモデリング/プロジェクト実装パターン/API設計・デプロイ含む)
developing-bashBashシェルスクリプティング・自動化ガイド(基礎、制御構造、I/O、プロセス制御、テスト、セキュリティ、パターン)
developing-fullstack-javascriptフルスタックJS
mastering-typescriptTypeScript包括ガイド(83項目の実装判断基準 + 型システム・関数・クラス・高度な型・非同期・モジュール・ビルド)
developing-mcpMCP (Model Context Protocol) サーバー/クライアント開発・アーキテクチャパターン・セキュリティ強化(脅威モデル・コード硬化・OIDC認証・LLM攻撃対策・エコシステム脅威・実装チェックリスト)
building-adk-agentsGoogle ADK (Agent Development Kit) AIエージェント開発ガイド(Agent、Tool、Runner、Session、Memory、Plugin System、Grounding、Context Management、Session Rewind/Resume、Action Confirmations、Event System、GKE Deployment含む9リファレンスファイル)
integrating-ai-web-appsVercel AI SDK + LangChain.js + MCPによるWebアプリAI統合

フロントエンド・デザイン

スキル説明
building-design-systemsデザインシステム構築・運用方法論(システム基礎・パターン分類・組織戦略・パターンライブラリ・UIパターンカタログ20+)
applying-design-guidelinesUI/UXデザイン設計(視覚デザイン・認知心理学・実践的UIルール101)
developing-storybookStorybook開発ガイド(CSF3・インタラクションテスト・a11y・ビジュアルリグレッション・Next.js統合・MSWモック)
designing-frontendフロントエンド実装(shadcn/ui統合)
implementing-designFigmaデザイン→コード
implementing-figmaFigma MCP統合・基本/高度ワークフロー・Code Connect・デザイントークン同期
designing-data-visualizationsデータビジュアライゼーション原則(チャート選択・カラースケール・デザインベストプラクティス・ストーリーテリング)
styling-with-tailwindTailwind CSSスタイリング方法論(v4プライマリ・ユーティリティファースト思想・セットアップ・モディファイア・コンポーネント設計・カスタマイズ・デザインシステム構築)

ブラウザ自動化・E2Eテスト

スキル説明
automating-browserBrowser Agent CLIによるブラウザ操作自動化(セマンティックロケーター、状態永続化、ネットワーク傍受)
testing-e2e-with-playwrightPlaywright Testによる包括的E2Eテスト(ロケーター戦略・フィクスチャ/POM・モッキング・エミュレーション・信頼性・CI/CD・拡張・アクセシビリティ・ビジュアルリグレッション・認証・フォーム・AI生成・実践パターン)

インフラ・ツール

スキル説明
designing-monitoring監視・オブザーバビリティシステム設計(アンチパターン、デザインパターン、レイヤー別戦略、テレメトリーパイプライン、アラート・オンコール・インシデント管理、オブザーバビリティ概念、SLO、サンプリング戦略、成熟度モデル)
developing-awsAWS開発包括ガイド(システム設計・CDP57パターン・VPCアーキテクチャ・エンタープライズ基盤・14業務システム・移行戦略・サーバーレス・CDK・EKS・SRE運用・FinOps/CCoE・セキュリティ・Bedrock GenAI・32リファレンスファイル)
developing-google-cloudGoogle Cloud 開発・セキュリティ・データエンジニアリング・ネットワーク・キャッシング包括ガイド(Cloud Runデプロイ + GCPプラットフォームセキュリティ深掘り: IAM・VPC・KMS・DLP・SCC・DevSecOps CI/CD・Zero Trust/BeyondCorp・Anthos・Incident Response + データエンジニアリング + ネットワークエンジニアリング: VPC設計・ハイブリッド接続・LB/CDN・ネットワーク監視・Traffic Director/Service Mesh + Memorystore: マネージドRedis/Memcachedキャッシング・パフォーマンスエンジニアリング・レジリエンス・32リファレンスファイル)
managing-dockerDocker包括的ガイド(Engine内部、ネットワーク、ボリューム、セキュリティ、AI/Wasm、開発ワークフロー、DB連携、監視/ログ、デプロイ戦略含む・14リファレンスファイル)
using-next-devtoolsNext.js DevTools
implementing-opentelemetryOpenTelemetry計装・Collector・オブザーバビリティ導入
implementing-loggingアプリケーションログ実装ガイド(ログ設計原則・構造化ログ・収集アーキテクチャ・分析・セキュリティログ・AI/MLログ分析)
developing-terraformTerraform/Terragrunt IaC開発(HCL・モジュール・ステート・Terragrunt・mise・AWS/GCP)
managing-keycloakKeycloak IAM包括ガイド(OIDC/SAML・SSO・Realm/Client/User管理・認証フロー・MFA・認可ポリシー・JWT Token管理・アプリ統合・Docker/K8sデプロイ・SPI拡張)
practicing-devopsDevOps方法論・IaCツール選定・オーケストレーション比較・CI/CD・プラットフォームエンジニアリング
managing-sdn-with-aiAI × SDN/SD-WAN管理ガイド(AIエージェントアーキテクチャ・SDN運用最適化・セキュリティ・インフラ自動化・SD-WAN・5リファレンスファイル)
using-anki-mcpAnki MCP Server統合(デッキ管理・カードレビュー・ノートタイプ・メディア管理・GUI統合)
using-drawio-mcpdraw.io MCP Server統合(XML/CSV/Mermaid形式でダイアグラム作成・ブラウザ表示)
creating-flashcardsEPUB/PDFからAnkiフラッシュカード一括作成(コンテンツ構造分析・選択肢リスト化・一括インポート)
viewing-diffsdifit GitHub風差分ビューア(git diff のブラウザ表示・自動インストール対応)
orchestrating-teamsAgent Teamオーケストレーション(チーム編成・タチコマ並列起動・進捗管理・docs先行開発)
orchestrating-codexCodex Agentオーケストレーション(planner→implementer逐次起動・ドキュメント先行開発。Claude Code Team非対応環境用)
translating-with-lmstudioLM Studioローカル LLM による英語→日本語翻訳(OpenAI互換API、フラッシュカード作成・スキル変換連携)
recognizing-imagesLM Studioローカル VLM による画像テキスト認識(OCR、単一ファイル/ディレクトリ一括処理、Markdown出力)
converting-epub-images画像ベースEPUBをLM Studio OCRで日本語テキスト(Markdown)に変換。~/Desktopに出力

ドキュメント・品質

スキル説明
mermaid-diagramsMermaidダイアグラム作成(22+種類:構造設計・フロー・プロジェクト管理・データ可視化・バージョン管理・思考整理・専門用途、23リファレンスファイル)
crafting-ai-copywritingAIコピーライティング(15の心理的プロンプト技法)
writing-latexLaTeX文書作成
generating-google-slidesGoogle Slides自動生成(GAS slideDataオブジェクト生成)
slidekit-createHTMLスライドプレゼンテーション生成(1スライド=1HTML、Tailwind CSS、15レイアウトパターン、5スタイル×5テーマ)
slidekit-templPDFプレゼンテーション→HTMLスライドテンプレート変換(視覚再現アプローチ)
authoring-agentsエージェント定義(agents/*.md)の作成ガイド(フロントマター・スキルプリロード・テンプレート)
authoring-skillsスキル作成・ソース変換・利用状況レビュー統合ガイド
searching-with-exaExa MCP統合(7カテゴリ検索: 企業・コード・人物・財務・学術・個人サイト・Tweet/X、Web検索第一優先ツール)
searching-webWeb検索 fallback(gemini CLI、Exa MCP使用不可時)
reviewing-with-coderabbitCodeRabbitコードレビュー
writing-zenn-articlesZenn技術記事の作成・投稿ワークフロー(フロントマター仕様・命名規則・品質チェック・Lint設定)
designing-training研修設計・ファシリテーション方法論(ニーズ分析・カリキュラム設計・90/20/8法則・EATフレームワーク・参加者主体技法・オンライン/ハイブリッド・スキルマップ・研修資料作成・12リファレンスファイル)
improving-presentationsプレゼンテーション改善ガイド(5領域: マインドセット準備・ストーリー構成・スライドデザイン・デリバリー・聴衆エンゲージメント、10冊統合、3つのゴール・核設計・4聴衆タイプ・三幕構成・AIDMA・空雨傘型・聞くパラダイム・緊張管理・Q&A対策・PUNCH原則、7ファイル)
writing-effective-prose効果的な文章術(論理構成・文レベル技術・表現・推敲・AI臭除去・技術文書・学術文書・大学レポート/論文(卒論・実験レポート・引用・剽窃防止)を統合)
practicing-design-thinkingデザイン思考プロセス方法論(共感・問題定義・発想・プロトタイプ・テストの5ステップ、タテマエメソッド・HMW・エクストリームユーザー法・雑っぴんぐ等EDP実践知識)

Scripts (1個)

スクリプト説明
convert-markdown-to-skill.shMarkdown→スキル変換スクリプト

Hooks (4個)

フックトリガー説明
detect-project-skillsSessionStartセッション開始時にプロジェクト構成を検出し、推奨スキルを自動提示
format-on-savePostToolUseファイル保存時の自動フォーマット(TypeScript/JSON/Terraform等)
notify-completeStopタスク完了時のデスクトップ通知
notify-waitingStop待機状態の通知

MCP Servers (11個)

サーバー用途
serenaコード分析・編集・メモリ管理
next-devtoolsNext.js開発ツール
deepwikiGitHub Wiki検索
puppeteerブラウザ自動化
chrome-devtoolsChrome DevTools統合
mcp-pandocドキュメント形式変換
shadcnshadcn/uiコンポーネント管理
dockerDockerコンテナ管理
terraformTerraformインフラ管理
sequentialthinking複雑な問題の構造化思考
drawiodraw.ioダイアグラム作成・表示

主な特徴

  • 並列実行モデル: タチコマ4体同時起動で独立タスクを並列処理
  • トークン効率化: /serenaコマンドによる構造化開発
  • 型安全性: any/Any型の使用を厳格に禁止
  • セキュリティファースト: 実装後のCodeGuard検証を必須化
  • 自動フォーマット: PostToolUseフックによるコード整形
  • 二段階ロード: SKILL.md(フロントマターのみ)+ INSTRUCTIONS.md(本文)でコンテキスト94.8%削減

Skills Info
Original Name:applying-solid-principlesAuthor:sumik5