
ai-tools-architect
Design and audit portable AI-tool configuration.
- version
- 0.1.21
- GitHub stars
- 347
Install
/plugin install ai-tools-architect@khanelinix-ai-toolsRun it inside Claude Code after adding the marketplace with /plugin marketplace add khaneliman/khanelinix.
Contents
Discovered from sourceSkills 1
AI Tools Architecture Playbook
Keep shared instructions, skills, plugins, and agents focused on the decisions they own, portable across hosts, and written as playbooks. Load detail when the task needs it, and use bundled scripts for exact, repeated mechanics.
Standards
Apply these tests to every instruction file, rule, skill, plugin, and agent you design or review, in any repository:
- Contributor docs own repository conventions. Repository agent files point
to
CONTRIBUTING.md,docs/, or the style guide instead of copying them, and require reading those sources before changes. - Portable by default. A skill, plugin, or agent must work outside the
repository that hosts it:
- Carry the recipes, constraints, examples, and source links it needs; do not trim it because one repository's instructions repeat them. Declared skill dependencies can supply shared methods.
- Never depend on host-repository paths, user-home paths, account or tenant names, or personal data. The audit flags the first two.
- Use the portable frontmatter fields and put host-only settings in host sidecars; scripts run on Linux and macOS, handle Windows where feasible, and degrade when an optional tool is missing.
- Mark host-bound tooling as host-only and keep it out of publication.
- Playbooks, not research notes. Write rules, an ordered workflow with completion criteria, and command reference. State each fact or limit directly. Leave out how a conclusion was reached, test counts, session details, and dates that will go stale; collect unverified behavior in one short list.
- Explain what changes the decision. Skip generic introductions and what the model already knows. Keep unfamiliar constraints, current API behavior, environment quirks, choices among valid approaches, and known failure modes.
- Remove duplication where sources load together. State shared guidance once at the right scope and link it from narrower files. Keep what a separately installed skill needs to stand alone.
- Use tools for mechanics and prose for judgment. Prefer scripts or CLIs for fragile or repeated queries, transformations, validation, and mutations. Keep selection, ambiguity resolution, and interpretation in the playbook.
Before changing these standards, or when a host behaves unexpectedly, check the upstream sources in refs/UPSTREAM.md. Its local rules override upstream defaults where they conflict.
Audit
Run the structural audit for a tree-wide review or any change to skill discovery, packaging, or publication:
python3 <skill-dir>/scripts/audit_ai_tools.py <ai-tools-root> --format markdown
The audit is read-only. Errors are objective structural failures; warnings, including the portability checks, are review candidates. Review implicit and explicit-only skill counts before adding another automatic trigger; the description budget is a repository setting, not a universal host limit. After changing canonical skills, run every bundled unit suite:
python3 <skill-dir>/scripts/run_skill_tests.py <canonical-skills-root>
Component References
Read the reference whose constraints affect the task:
- Skills (reusable workflows): refs/SKILLS.md
- Plugins and marketplaces (distribution): refs/PLUGINS.md
- Subagents and custom agents (context and tool boundaries): refs/SUBAGENTS.md
- Path-gated rules and instruction files: refs/RULES.md
- Commands and prompt files (one-shot prompts): refs/COMMANDS.md
- Agent-facing prose: refs/writing-for-agents/REFERENCE.md
- Skill, workflow, or model-route evaluation: refs/workflow-evaluation.md
- Repository instruction setup or full-surface audits: refs/INITIALIZATION.md, then only the component references it selects.
For a broad audit, inventory the layers and prioritize concrete context, routing, and execution problems. Ask only when a material scope choice remains unresolved.
Sponsors
Details
- Marketplace
- khaneliman/khanelinix
- Source
- modules/common/ai-tools/skills/ai-tools-architect
- Author
- khaneliman
- Category
- Developer Tools
More from khaneliman/khanelinix
All 43- architectv0.1.7
- arenav0.1.5
- bevy-toolkitv0.1.6
- blast-radiusv0.1.6
- blender-toolkitv0.3.2
- develop-web-gamev0.1.7
- diagnosing-bugsv0.1.3
- dotnet-toolkitv0.1.2
- engineering-principlesv0.1.22
- engineering-workflowv0.1.27
- figure-it-outv0.1.10
- git-toolkitv0.1.15
- github-toolkitv0.1.33
- howv0.1.7
- interrogatev0.1.10
- jj-toolkitv0.1.8
- lua-toolkitv0.2.0
- mcp-builderv0.1.6
- memory-profilerv0.1.6
- microsoft-teamsv0.1.0
- nix-toolkitv0.4.12
- okf-memoryv0.1.6
- performance-forensicsv0.1.4
- planning-with-filesv0.1.9