Tools Knowledge Tool

What is it?

The Tools Knowledge tool is Yukkai's built-in documentation lookup system. It lets you retrieve detailed specifications and overviews for any tool, skill, agent, design system, or knowledge base that Yukkai has access to — all from within a conversation.

Think of it as a self-aware reference manual: instead of hunting through external docs or guessing at parameters, you can ask Yukkai to look up its own capabilities on the fly.

How it works

The tool operates through two main action types:

• List actions — Return an overview of all available items in a category. These are useful when you want to see what exists without diving into specifics.
• Detail action — Returns full documentation for a single, specific item by name or ID.

Each detail lookup targets one of five target types:

Target	Description
tool	A Yukkai built-in tool (e.g., rag, file_write)
skill	An activated skill or expertise module
knowledge	An indexed knowledge base entry
agent	A sub-agent role definition
design	A design system specification

How to use it

You don't need to call this tool yourself — simply ask Yukkai about a tool, skill, or capability in natural language, and it will use the Tools Knowledge tool behind the scenes to fetch accurate, up-to-date documentation.

If you want to explore what's available, you can ask things like:

• "What tools do you have?"
• "List all your skills."
• "Show me the agents you can launch."

To get specifics on a single item:

• "Give me the full docs for the RAG tool."
• "What does the vault tool do?"
• "Show me details on the design system."

Examples

Listing all available tools

User: "What tools are available?"

→ Yukkai calls tools_knowledge with:
  action: "list_tools"

→ Returns an overview of every tool, its name, and a short description.

Getting full details on a specific tool

User: "Give me the full documentation for the RAG tool."

→ Yukkai calls tools_knowledge with:
  action: "detail"
  target: "tool"
  name:   "rag"

→ Returns full parameter list, valid values, and usage notes.

Browsing skills and agents

User: "What skills do you have active?"

→ Yukkai calls tools_knowledge with:
  action: "list_skills"

→ Returns each skill's name, ID, and description.

Looking up an agent role

User: "What sub-agents can you launch?"

→ Yukkai calls tools_knowledge with:
  action: "list_agents"

→ Returns agent roles, their system prompts, and allowed tools.

Tips & best practices

• Ask in plain language — You never need to know the exact parameter names. Yukkai translates your question into the right lookup automatically.
• Use list first, then detail — If you're unsure what's available, start by asking for a list. Once you spot something interesting, ask for its full details.
• Great for discovering hidden capabilities — Yukkai has many tools and skills that aren't always obvious. Browsing the list is a quick way to find features you didn't know existed.
• Documentation is always current — Because the tool queries Yukkai's internal registry, the documentation you get reflects the actual installed version — no risk of outdated wiki pages.
• Combine with other tools — After learning about a tool's capabilities, you can immediately ask Yukkai to use it. For example, look up the RAG tool, then ask it to search your knowledge base.