Mako Database
Use this skill for direct database introspection. These tools require the project to have a live DB binding configured. If the user asks how app code uses database objects, use trace or neighborhood tools instead.
Tools
db_ping
Use to verify database connectivity and project wiring.
- Best when DB tools seem unavailable or the user asks whether the DB is
connected.
- Use before deeper DB queries when the binding is uncertain.
db_columns
Use to inspect columns and primary-key details for one or more tables.
- Best for narrow column questions.
- Use
db_table_schemawhen indexes, constraints, triggers, or broader table
shape matter.
db_fk
Use to inspect foreign keys and relationships.
- Best for inbound/outbound relationship questions.
- Pair with
table_neighborhoodwhen code readers/writers also matter.
db_rls
Use to inspect row-level security status and policies.
- Best for policy and protection questions.
- Pair with
tenant_leak_auditfor broader tenant-boundary risk review.
db_rpc
Use to inspect database RPC/function definitions, signatures, args, return shape, language, and security.
- Pair with
rpc_neighborhoodortrace_rpcwhen app-code callers matter.
db_table_schema
Use to inspect the full table shape, including columns, indexes, constraints, foreign keys, RLS, and triggers.
- Use when column-only output is insufficient.
- Pair with
trace_tableortable_neighborhoodwhen code usage matters.
Feedback Logging
Log agent_feedback when a DB introspection result here was notably useful, partial, noisy, stale, wrong, or wasted the turn. Skip routine calls.
Required procedure (see /mako-ai:mako-guide for full rules and reason-code vocabulary):
- Call
recall_tool_runsto get the prior run'srequestId. Do not
fabricate one — if no run is recalled, skip feedback.
- Call
agent_feedbackwithreferencedToolName,
referencedRequestId, grade: "full" | "partial" | "no", reasonCodes from the starter vocabulary in /mako-ai:mako-guide, and a short reason.
See Also
- Use
/mako-ai:mako-neighborhoodsfor table/RPC context that combines DB facts
with app-code usage.
- Use
/mako-ai:mako-tracefor table/RPC traces through code and schema. - Use
/mako-ai:mako-workflowfor tenant audits and review artifacts.