CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ai-first-engineering

AI エージェントが大量の実装出力を生成するチームのためのエンジニアリング運用モデル。

Quality

54%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./docs/ja-JP/skills/ai-first-engineering/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

58%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is admirably lean and well-sectioned — no wasted tokens — but it reads as a manifesto of high-level principles rather than operational guidance. No concrete examples, templates, or sequences show how to actually apply the review targets, architecture requirements, or test standards, so it is efficient but not actionable.

Suggestions

Add one concrete artifact per section, e.g. a review checklist template or a worked example of a「測定可能な受け入れ基準」instead of the bare principle.

Sequence the guidance into an applicable workflow (e.g., 要件の分解 → アーキテクチャ制約の設定 → レビューチェックリスト → テスト標準の適用) with explicit validation checkpoints.

Include a short worked example of the testing standards (必須のリグレッションカバレッジ + 明示的なエッジケースのアサーション) applied to a typical generated-code change.

DimensionReasoningScore

Conciseness

The ~45-line body is pure directives with zero padding and no explanation of concepts Claude already knows — e.g.「レビュー対象:動作のリグレッション/セキュリティの前提/データの整合性/障害処理/ロールアウトの安全性」. Every token earns its place, matching the 'lean and efficient; assumes Claude's competence' anchor; there are no instances of over-explanation that would justify a 4.

5 / 5

Actionability

The guidance is principle-level —「計画の品質はタイピングスピードより重要」「曖昧な作業を明確に分解する」— with no commands, code, templates, examples, or step-level specifics for an instruction-only skill. It rises above anchor 1 only because bullets like「操作されたドメインに対する必須のリグレッションカバレッジ」and「明示的なエッジケースのアサーション」give concrete high-level hints; it stays at 2 because the specific steps to execute anything are missing.

2 / 5

Workflow Clarity

The sections (プロセスの変化、アーキテクチャ要件、コードレビュー、採用と評価シグナル、テスト標準) are parallel principle lists with no sequenced workflow, checkpoints, or validation steps for applying them. This is a multi-faceted guidance skill rather than a single unambiguous-action skill, so the simple-skill exception does not apply; it sits at anchor 2 rather than 1 only because each section is internally coherent and thematically ordered.

2 / 5

Progressive Disclosure

At ~45 lines with no bundle files (references/, scripts/, assets/ are absent and no file paths are cited), the body is organized into clearly headed, well-scoped sections that cover the whole topic without needing external references. This matches the rubric's exception allowing a 5 for short, well-organized skills with no need for external files.

5 / 5

Total

14

/

20

Passed

Description

28%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description identifies its niche — engineering operations for teams whose output is generated by AI agents — but it is a single abstract categorization sentence. It names no concrete capabilities, contains almost no natural trigger terms, and entirely lacks 'use when' guidance, so it would rarely be selected by matching against what users actually say.

Suggestions

Add an explicit trigger clause, e.g.「AI エージェントによる開発におけるプロセス設計、コードレビュー基準、アーキテクチャ、テスト標準を策定する際に使用します」.

Replace the abstract label「エンジニアリング運用モデル」with an enumeration of concrete capabilities: プロセス設計、レビュー基準、アーキテクチャ要件、テスト標準.

Include natural user phrasings as trigger terms, such as「AI ファースト開発」「エージェントによるコード生成」「AI チームのコードレビュー」.

DimensionReasoningScore

Specificity

The description names its domain —「AI エージェントが大量の実装出力を生成するチームのためのエンジニアリング運用モデル」— but lists no concrete actions or capabilities whatsoever. It matches anchor 2 ('names the domain but actions are minimal or generic'): not 3 because no concrete actions (e.g., process design, review standards) are stated, and not 1 because the domain and audience are clearly identified.

2 / 5

Completeness

It provides only a categorical 'what' (an「エンジニアリング運用モデル」) and no 'when' at all — there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 by guideline. The 'what' is too vague to count as a 'clear what' (anchor 3), so it lands on anchor 2 ('has a vague what and no when').

2 / 5

Trigger Term Quality

「AI エージェント」 is a keyword users might plausibly say, but「エンジニアリング運用モデル」 is abstract jargon no user would utter when they need this skill. Natural phrases like「AI ファースト開発」「エージェントによるコード生成」「AI チームのコードレビュー」 are absent, matching anchor 2 ('one or two generic keywords; missing the natural phrases users say') rather than 3.

2 / 5

Distinctiveness Conflict Risk

The framing around teams where AI agents generate large volumes of implementation output carves out a recognizable niche, but the description could overlap with any AI-assisted development process, prompt-engineering, or code-review skill. It matches anchor 3 ('somewhat specific but could still overlap with similar skills') — not 4 because no distinct triggers are given.

3 / 5

Total

9

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

affaan-m/ECC

Path

docs/ja-JP/skills/ai-first-engineering/SKILL.md

Reviewed

Table of Contents

Is this your skill?

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.