SKILL.md

name: component-architect description: | Enforces official Claude Code component standards. Use when creating skills, agents, commands, or hooks. Validates existing components and offers remediation. Implements the "one skill = one specialized agent" architecture pattern. allowed-tools: Read, Write, Edit, Grep, Glob, Bash, WebFetch model: sonnet context: fork agent: component-architect-agent user-invocable: true hooks: PreToolUse: - matcher: "Write|Edit" hooks: - type: command command: "$HOME/.claude/skills/component-architect/scripts/validate-component.sh" PostToolUse: - matcher: "Write|Edit" hooks: - type: command command: "$HOME/.claude/skills/component-architect/scripts/log-component.sh"

Component Architect

Core Responsibilities

Pre-Creation Validation: Check official docs before generating any component
Existing Component Audit: Scan ~/.claude for non-compliant components
Remediation Orchestration: Spawn subagents to fix non-compliant files
Architecture Enforcement: Apply "one skill = one specialized agent" pattern

Official Frontmatter Reference

Component	Required	Optional
SKILL.md	name, description	allowed-tools, model, context, agent, hooks, user-invocable
Agent .md	name, description	tools, disallowedTools, model, permissionMode, skills, hooks
Command .md	(none)	description, allowed-tools, model, argument-hint
plugin.json	name, description	author
hooks.json	hooks object	description

Validation Commands

Validate All Components

/component-architect validate

Validate Specific Type

/component-architect validate --type skills
/component-architect validate --type agents
/component-architect validate --type hooks

Apply Architecture Pattern

/component-architect apply-pattern --skill skill-name

Architecture Pattern: One Skill = One Agent

For every active skill:

Set context: fork in SKILL.md
Create designated agent with matching name pattern
Configure agent with:
- Intelligent model selection based on task complexity
- Appropriate permissionMode for the workflow
- Complementary skills that enhance the primary skill
- Scoped hooks for lifecycle management
- Restricted tools appropriate to the domain

Model Selection Matrix

Complexity	Model	Indicators
High	opus	Architecture, debugging, multi-domain reasoning
Medium	sonnet	Implementation, refactoring, moderate analysis
Low	haiku	Searches, simple transforms, quick lookups
Inherited	inherit	When parent context model is appropriate

Permission Mode Selection Matrix

Scenario	Mode	Use When
Complex multi-step	plan	High complexity requiring human feedback before implementation
Edge case handling	acceptEdits	Potential edge cases need user confirmation on edits
Routine execution	bypassPermissions	Clear requirements, preplanned, or promise completion
Standard workflow	default	Normal permission checking with prompts
Deny risky ops	dontAsk	Auto-deny prompts (explicitly allowed tools still work)

Remediation Workflow

Scan component directories for non-compliant files
Generate remediation plan per file
Spawn parallel subagents for batch updates
Verify all changes post-remediation

Integration References

scripts/validate-component.sh - PreToolUse validation
scripts/log-component.sh - PostToolUse logging
scripts/audit-components.py - Full audit script
references/official-spec.md - Cached official docs

Score

Total Score

40/100

Based on repository quality metrics

✓SKILL.md

SKILL.mdファイルが含まれている

+20

○LICENSE

ライセンスが設定されている

0/10

○説明文

100文字以上の説明がある

0/10

○人気

GitHub Stars 100以上

0/15

○最近の活動

3ヶ月以内に更新がある

0/10

○フォーク

10回以上フォークされている

0/5

✓Issue管理

オープンIssueが50未満

+5

✓言語

プログラミング言語が設定されている

+5

○タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon