Agent skill
template-candidates
Analyse files for ArchitectKB template repository suitability
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/template-candidates
SKILL.md
Skill: Template Candidates
Command: /template-candidates [--category <type>]
Model: 🟡 Sonnet
Agent: None (direct execution)
Purpose
Analyse files in this vault and identify candidates suitable for the ArchitectKB template repository. Performs detailed content analysis to ensure files are generic and reusable.
When to Use
- After
/template-changelogidentifies new/modified files - Before running
/template-sync - When deciding what features to contribute upstream
Categories
Filter by category with --category:
| Category | Directory | Description |
|---|---|---|
scripts |
.claude/scripts/ |
Python/Shell automation |
skills |
.claude/skills/ |
Skill definitions |
schemas |
.claude/schemas/ |
JSON validation schemas |
hooks |
.claude/hooks/ |
Pre/post execution hooks |
rules |
.claude/rules/ |
Reference documentation |
templates |
Templates/ |
Note templates |
all |
All above | Full analysis |
Implementation
Step 1: Scan for New/Modified Files
Compare with template repo:
VAULT = Path("~/Documents/GitHub/BA-DavidOliver-ObsidianVault").expanduser()
TEMPLATE = Path("~/Documents/GitHub/ArchitectKB").expanduser()
DIRS_TO_COMPARE = [
".claude/scripts",
".claude/skills",
".claude/schemas",
".claude/hooks",
".claude/rules",
"Templates",
]
Step 2: Content Analysis
For each candidate file, check for:
Disqualifying Content (AUTO-EXCLUDE)
| Pattern | Reason |
|---|---|
Acme Corp, BA-, britishairways |
Company-specific |
@ba.com, atlassian.net/wiki/spaces/BA |
Internal URLs |
| API keys, tokens, passwords | Security risk |
/Users/david.oliver/ |
Hardcoded personal paths |
ERPSystem, Alpha, Beta, DataPlatform, AlertHub |
BA-specific projects/systems |
notion.so/ba-workspace |
Internal integrations |
Qualifying Content (GOOD SIGNS)
| Pattern | Reason |
|---|---|
| Generic variable names | $VAULT_PATH, ${PROJECT} |
| Configuration via environment | os.environ.get() |
| Template placeholders | {{company}}, <your-org> |
| Well-documented functions | Docstrings, comments |
| Error handling | Try/except, validation |
Step 3: Scoring System
Score each file 0-100:
| Score | Classification | Action |
|---|---|---|
| 90-100 | Ready | Can sync directly |
| 70-89 | Minor edits | Small sanitisation needed |
| 50-69 | Needs work | Significant generalisation required |
| 0-49 | Not suitable | Too specific or contains secrets |
Step 4: Generate Report
Output a structured report:
# Template Candidates Report
Generated: 2026-02-01
## Summary
| Category | Ready | Minor Edits | Needs Work | Excluded |
|----------|-------|-------------|------------|----------|
| scripts | 3 | 2 | 1 | 4 |
| skills | 5 | 3 | 2 | 1 |
| ... | | | | |
## Ready for Sync (Score 90+)
### .claude/scripts/archive-orphan-attachments.py
- **Score:** 95
- **Status:** Ready
- **Notes:** Fully generic, no company references
### .claude/schemas/location.schema.json
- **Score:** 100
- **Status:** Ready
- **Notes:** Pure schema, no customisation needed
## Minor Edits Needed (Score 70-89)
### .claude/skills/sync-notion/SKILL.md
- **Score:** 75
- **Status:** Minor edits
- **Issues:**
- Line 23: Contains hardcoded database ID
- Line 45: References BA-specific workspace
- **Fix:** Replace with placeholder variables
## Excluded (Score <50)
### .claude/scripts/sync-ba-confluence.py
- **Score:** 20
- **Reason:** Entirely BA-specific integration
- **Action:** Do not sync
## Recommended Actions
1. Run `/template-sync` for 8 ready files
2. Edit 5 files with minor issues
3. Review 3 files needing significant work
Output Location
Save report to: .claude/reports/template-candidates-YYYY-MM-DD.md
Related Skills
/template-changelog- Generate changelog entries/template-sync- Execute the sync
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?