Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →Defines environment variables, architecture design, and build/test commands. Use when configuring environment or designing architecture.
.claude/skills/shinpr-technical-spec/SKILL.md| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-02 | ✗→✓ | ▲ Improved | 21% | 0% |
| case-03 | ✗→✓ | ▲ Improved | 52% | 0% |
| case-04 | ✗→✓ | ▲ Improved | 44% | 0% |
| case-05 | ✗→✓ | ▲ Improved | 48% | 0% |
| case-09 | ✗→✓ | ▲ Improved | 36% | 0% |
技術やコマンドに固有のルールを適用する前に、マニフェスト、ロックファイル、ビルド・テスト設定、CI定義、代表的なソースファイルを確認する。ツール、スクリプト、パスエイリアス、ランタイムは、リポジトリ内の根拠に明記されている場合にのみ確認済みとして扱う。周辺のパターンから導いた結論には推測であることを明記する。不足している判断によってアーキテクチャ、互換性、セキュリティ、検証方法が変わる場合は作業を止め、必要な設定またはユーザー判断を具体的に示す。
リポジトリ設定からTypeScriptアプリケーションであることを確認できる場合に、このルールを適用する。現行要件と合意済みの制約を、モジュールの責務、依存方向、データフロー、検証境界へ明示的に対応づけてアーキテクチャを選択する。
.envファイルはバージョン管理の対象外とし、必要な変数名はシークレットを含まないサンプルファイルで示す以下の観測可能な判断に基づいてアーキテクチャを選択する：
packageManagerフィールド、ロックファイル、確立済みのCIコマンドの順にパッケージマネージャーを判定する。選択したマニフェストに存在するスクリプトだけを実行する。
build - TypeScriptビルドtype-check - 型チェック（emit なし）test - テスト実行test:safe - 安全なテスト実行（自動クリーンアップ付き）cleanup:processes - Vitestプロセスのクリーンアップ品質チェック実行前に、変更対象領域にどのような品質メカニズムが存在するかを特定する:
品質チェックは実装完了時に必須：
Phase 1-3: コード品質チェック
フェーズ移行の証跡: 適用対象となる静的チェックとドメイン固有チェックがすべて正常終了していること。必須スクリプトが存在しない場合はマニフェストまたは設定のパスとともに報告し、確立済みの同等コマンドが特定されるまで次のPhaseへ進まない。
Phase 4: テスト
test - テスト実行フェーズ移行の証跡: 適用対象として設定されているテストスイートがすべて成功していること。環境依存のテストスイートを実行できない場合は、ブロック要因となる前提条件を具体的に記録する。
Phase 5: コード品質再検証
check:code - コード品質の再検証（Phase 4でのテスト修正による副作用を清掃）完了証跡: テストに伴う修正後も静的チェックとドメイン固有チェックが成功し、ビルドが成功していること。必須テストはすべて成功しているか、実行を妨げる要因が明示されていること。
check:all - 全体統合チェック（check:code + test）※手動一括確認用format - フォーマット修正lint:fix - Lint修正cleanup:processes スクリプトを実行| Case | Status | Duration (ms) | Turns | Tokens | Tool calls | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Without | With | Δ | Without | With | Δ | Without | With | Δ | Without | With | Δ | ||
case-01 | fail→fail | 33,389 | 23,564 | -29% | 1 | 1 | 0% | 4,706 | 5,445 | +16% | 0 | 0 | — |
case-02 | fail→pass | 22,904 | 21,785 | -5% | 1 | 1 | 0% | 3,818 | 4,624 | +21% | 0 | 0 | — |
case-03 | fail→pass | 30,123 | 26,238 | -13% | 1 | 1 | 0% | 3,956 | 6,021 | +52% | 0 | 0 | — |
case-04 | fail→pass | 18,912 | 25,937 | +37% | 1 | 1 | 0% | 3,463 | 4,970 | +44% | 0 | 0 | — |
case-05 | fail→pass | 24,775 | 21,160 | -15% | 1 | 1 | 0% | 3,423 | 5,059 | +48% | 0 | 0 | — |
case-06 | pass→pass | 20,323 | 15,492 | -24% | 1 | 1 | 0% | 2,758 | 4,568 | +66% | 0 | 0 | — |
case-07 | pass→pass | 18,453 | 21,033 | +14% | 1 | 1 | 0% | 2,815 | 4,233 | +50% | 0 | 0 | — |
case-08 | pass→pass | 22,247 | 25,985 | +17% | 1 | 1 | 0% | 3,827 | 5,674 | +48% | 0 | 0 | — |
case-09 | fail→pass | 17,188 | 16,801 | -2% | 1 | 1 | 0% | 2,792 | 3,795 | +36% | 0 | 0 | — |
case-10 | pass→pass | 18,950 | 12,804 | -32% | 1 | 1 | 0% | 2,730 | 3,382 | +24% | 0 | 0 | — |
case-11 | pass→pass | 17,180 | 26,475 | +54% | 1 | 1 | 0% | 3,304 | 5,523 | +67% | 0 | 0 | — |
case-12 | pass→pass | 28,181 | 25,779 | -9% | 1 | 1 | 0% | 3,712 | 5,616 | +51% | 0 | 0 | — |
case-13 | pass→pass | 21,621 | 25,905 | +20% | 1 | 1 | 0% | 3,977 | 5,561 | +40% | 0 | 0 | — |
case-14 | fail→pass | 22,865 | 18,515 | -19% | 1 | 1 | 0% | 3,370 | 4,183 | +24% | 0 | 0 | — |
case-15 | pass→pass | 16,289 | 14,508 | -11% | 1 | 1 | 0% | 2,230 | 3,541 | +59% | 0 | 0 | — |
case-16 | fail→pass | 19,663 | 18,653 | -5% | 1 | 1 | 0% | 3,218 | 4,604 | +43% | 0 | 0 | — |
case-17 | pass→pass | 21,545 | 19,656 | -9% | 1 | 1 | 0% | 3,641 | 4,718 | +30% | 0 | 0 | — |
case-18 | fail→pass | 18,908 | 36,240 | +92% | 1 | 1 | 0% | 2,926 | 3,793 | +30% | 0 | 0 | — |
case-19 | fail→pass | 24,298 | 25,917 | +7% | 1 | 1 | 0% | 3,259 | 5,136 | +58% | 0 | 0 | — |
case-20 | pass→pass | 9,109 | 8,191 | -10% | 1 | 1 | 0% | 1,726 | 2,858 | +66% | 0 | 0 | — |
case-21 | pass→pass | 11,260 | 12,312 | +9% | 1 | 1 | 0% | 1,601 | 2,902 | +81% | 0 | 0 | — |
case-22 | pass→fail | 15,213 | 3,441 | -77% | 1 | 1 | 0% | 2,244 | 1,737 | -23% | 0 | 0 | — |
DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 22 cases were attempted. The headline lift of +36 percentage points is the difference between those two pass rates over the 22 comparable cases. 1 case got worse with the skill loaded, and it is included in that figure.
Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.
Other measured skills in the registry, with their headline benchmark lift.