テスト駆動開発とGoコードの高品質を保証するための包括的なテスト戦略。
36
32%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./docs/ja-JP/skills/golang-testing/SKILL.mdQuality
Discovery
22%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This description is too abstract and lacks concrete actions and explicit trigger guidance. While it identifies the domain (Go, TDD), it fails to specify what the skill actually does (e.g., writing tests, generating mocks, running coverage) and provides no 'Use when...' clause to help Claude select it appropriately. The description reads more like a mission statement than a functional skill description.
Suggestions
Add specific concrete actions the skill performs, e.g., 'Goのユニットテスト作成、テーブル駆動テスト設計、モック生成、カバレッジ分析を行う' (creates unit tests, designs table-driven tests, generates mocks, analyzes coverage).
Add an explicit 'Use when...' clause, e.g., 'Use when the user asks about writing Go tests, improving test coverage, setting up TDD workflows, or mentions go test, testing, or テスト.'
Include common natural trigger terms in both Japanese and English that users would say, such as 'unit test', 'go test', 'coverage', 'mock', 'テストコード', 'カバレッジ'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description says '包括的なテスト戦略' (comprehensive test strategy) and mentions TDD and Go code quality, but does not list any concrete actions like 'write unit tests', 'generate test files', 'run test suites', or 'create mocks'. It remains abstract and vague about what the skill actually does. | 1 / 3 |
Completeness | The description partially addresses 'what' (test strategy for Go) but is vague about it, and completely lacks any 'when' clause or explicit trigger guidance. There is no 'Use when...' or equivalent instruction for Claude to know when to select this skill. | 1 / 3 |
Trigger Term Quality | It includes some relevant keywords like 'テスト駆動開発' (TDD), 'Go', and 'テスト' (test), which users might naturally mention. However, it misses common variations like 'unit test', 'table-driven test', 'go test', 'coverage', 'mock', or English equivalents that users might use. | 2 / 3 |
Distinctiveness Conflict Risk | The mention of 'Go' and 'テスト駆動開発' (TDD) provides some specificity that narrows the domain, but 'テスト戦略' (test strategy) is broad enough to potentially overlap with other testing-related skills or general Go development skills. | 2 / 3 |
Total | 6 / 12 Passed |
Implementation
42%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is essentially a comprehensive Go testing tutorial/reference that covers nearly every testing topic in Go. While the code examples are high-quality and executable, the document is far too verbose for a skill file — it explains many patterns Claude already knows well (table-driven tests, httptest, benchmarks, etc.) and presents everything in a single monolithic file. The content would benefit enormously from aggressive trimming to only project-specific conventions and splitting advanced topics into separate referenced files.
Suggestions
Reduce the content by 70-80% — remove standard Go testing patterns Claude already knows (table-driven tests, httptest, benchmarks, fuzzing basics) and focus only on project-specific conventions, preferred patterns, or non-obvious decisions.
Split advanced topics (database testing, fuzzing, benchmarks, HTTP testing) into separate referenced files and keep SKILL.md as a concise overview with links.
Add a clear decision workflow: when to use which testing approach, when to write integration vs unit tests, and what validation steps to follow before committing tests.
Remove explanatory comments like '// ヘルパーとしてマーク(スタックトレースに表示されない)' that explain standard Go behavior Claude already understands.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | This is extremely verbose at ~500+ lines, covering nearly every Go testing topic (TDD, table-driven tests, mocking, HTTP testing, database testing, benchmarks, fuzzing, parallelization, coverage, etc.). Much of this is standard Go knowledge Claude already possesses — table-driven tests, t.Helper(), httptest, benchmarks are all well-documented patterns that don't need exhaustive examples. The skill reads like a Go testing tutorial rather than a concise reference adding novel value. | 1 / 3 |
Actionability | All code examples are concrete, executable Go code with proper imports and complete function signatures. Commands are copy-paste ready (e.g., `go test -coverprofile=coverage.out ./...`). The examples cover real patterns with both test and implementation code shown together. | 3 / 3 |
Workflow Clarity | The TDD workflow (write test → implement → refactor) is mentioned but the overall skill lacks a clear sequential workflow for when/how to apply these patterns. There are no validation checkpoints or decision trees for choosing between approaches. The content is organized by topic rather than by workflow steps. | 2 / 3 |
Progressive Disclosure | This is a monolithic wall of text with no references to external files or any layered structure. All content — from basic assertions to fuzzing to database testing to benchmarks — is inlined in a single massive document. Much of this content (e.g., database testing, fuzzing, benchmarks) could be split into separate referenced files. | 1 / 3 |
Total | 7 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (960 lines); consider splitting into references/ and linking | Warning |
Total | 10 / 11 Passed | |
928076c
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.