takt-analyzer

Analyze TAKT pieces and facets for structural validation and style compliance.

26|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/j5ik2o/ai-tools --skill takt-analyzer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: takt-analyzer
Source: https://github.com/j5ik2o/ai-tools/tree/main/plugins/takt/skills/takt-analyzer
Command: npx skills add https://github.com/j5ik2o/ai-tools --skill takt-analyzer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you identify and fix problems in your TAKT pieces and facets, ensuring they adhere to best practices and improving your AI agent's performance and reliability.

Core Features & Use Cases

  • Automated Analysis: Automatically checks piece YAML structure, facet quality, and rule design against official standards.
  • Log-based Diagnostics: Analyzes execution logs (.takt/logs/*.jsonl) to find performance bottlenecks, rule evaluation inefficiencies, and ABORT rates.
  • Use Case: Before committing a new piece, run takt analyze to catch potential issues like incorrect YAML structure, style guide violations in facets, or inefficient rule logic, preventing runtime errors and improving overall agent quality.

Quick Start

Use the takt-analyzer skill to analyze the piece located at './my-takt-piece/SKILL.md'.

Frequently Asked Questions about takt-analyzer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate TAKT piece YAML structure and check facet quality?

To validate TAKT piece YAML structure and check facet quality, an automated analysis checks piece YAML structure, facet quality, and rule design against official style guides. This identifies structural issues, style guide violations, and unused facets to ensure best practices.

What is inter-facet consistency analysis in TAKT rule design?

Inter-facet consistency analysis in TAKT rule design evaluates alignment across facets within a piece. It detects inconsistencies and unused facets by comparing against official style guides and engine specifications to ensure rule design optimization.

How do I diagnose TAKT execution logs for rule evaluation bottlenecks?

To diagnose TAKT execution logs for rule evaluation bottlenecks, log-based diagnostics analyze `.takt/logs/*.jsonl` files. This reports rule evaluation efficiency, identifies loop hotspots, and calculates ABORT rates to pinpoint performance issues.

Can I detect unused facets and style guide violations before committing a TAKT piece?

Yes, you can detect unused facets and style guide violations before committing a TAKT piece by running an analysis tool. It checks piece YAML structure and facet quality against official standards to catch potential issues and prevent runtime errors.

What is the best way to optimize TAKT rule design and improve agent performance?

The best way to optimize TAKT rule design and improve agent performance is to analyze pieces for rule design optimization and run log-based diagnostics. This identifies inefficient rule logic, loop hotspots, and high ABORT rates to enhance reliability.