Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/awslabs/agent-plugins/dsqlnpx skills add awslabs/agent-plugins --skill dsqlgit clone --depth 1 https://github.com/awslabs/agent-pluginsWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00227 | $0.05294 |
| Opus 5 | $0.00113 | $0.02647 |
| Sonnet 5 | $0.00045 | $0.01059 |
| Haiku 4.5 | $0.00023 | $0.00529 |
Grade A, and why
dsql scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 300 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Amazon Aurora DSQL Skill
Aurora DSQL is a serverless, PostgreSQL-compatible distributed SQL database. This skill covers direct query execution via MCP tools, schema management, migrations, multi-tenant isolation, IAM auth, and bulk data loading via aurora-dsql-loader.
Reference Files
Load these files as needed for detailed guidance:
Core:
| Reference | When to Load | Contains |
|---|---|---|
| development-guide.md | ALWAYS before schema changes or DB operations | Best practices, DDL rules, transaction limits, app-layer referential integrity |
| language.md | MUST load for language-specific choices | Driver selection, DSQL Connectors, connection code |
| access-control.md | MUST load for roles, grants, or sensitive data | Scoped role setup, IAM-to-database role mapping |
| troubleshooting.md | SHOULD load for errors or unexpected behavior | OCC errors, connection failures, cluster state errors, token expiry, DDL rejection causes |
| dsql-examples.md | Load for implementation examples | Multi-tenant schema examples, batch operations, FK validation patterns, connection pooling |
| onboarding.md | User requests "Get started with DSQL" | Interactive step-by-step guide |
| occ-retry-patterns.md | MUST load for OCC retry code or conflict mitigation | DSQL Connectors, manual retry pattern, idempotent design |
What ships with it
60 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- mcp/mcp-setup.md 6.7 KB
- mcp/mcp-tools.md 2.0 KB
- mcp/platforms/claude-code.md 3.6 KB
- mcp/platforms/codex.md 1.6 KB
- mcp/platforms/gemini.md 2.1 KB
- mcp/platforms/kiro.md 2.8 KB
- mcp/tools/database-tools.md 4.6 KB
- mcp/tools/documentation-tools.md 1.3 KB
- mcp/tools/input-validation.md 3.3 KB
- mcp/tools/safe_query.py 10 KB runs code
- mcp/tools/workflow-patterns.md 2.9 KB
- references/access-control.md 5.0 KB
- references/auth/authentication-guide.md 4.4 KB
- references/auth/connectivity-tools.md 8.7 KB
- references/auth/scaling-guide.md 3.9 KB
- references/data-loading.md 6.0 KB
- references/ddl-migrations/batched-migration.md 2.5 KB
- references/ddl-migrations/column-operations.md 5.0 KB
- references/ddl-migrations/constraint-operations.md 5.7 KB
- references/ddl-migrations/overview.md 7.2 KB
- references/development-guide.md 9.1 KB
- references/dsql-examples.md 1.5 KB
- references/dsql-lint.md 9.5 KB
- references/examples/connection.md 2.5 KB
- references/examples/data-operations.md 2.9 KB
- references/examples/migrations.md 1.6 KB
- references/examples/patterns.md 6.1 KB
- references/examples/schema.md 1.6 KB
- references/language.md 8.6 KB
- references/mysql-migrations/ddl-auto-increment.md 3.9 KB
- references/mysql-migrations/ddl-batching.md 1.0 KB
- references/mysql-migrations/ddl-column-changes.md 1.1 KB
- references/mysql-migrations/ddl-constraints.md 2.6 KB
- references/mysql-migrations/ddl-operations.md 2.9 KB
- references/mysql-migrations/ddl-structural.md 3.7 KB
- references/mysql-migrations/ddl-type-alternatives.md 4.3 KB
- references/mysql-migrations/full-example.md 7.3 KB
- references/mysql-migrations/type-mapping.md 14 KB
- references/occ-retry-patterns.md 5.7 KB
- references/onboarding.md 14 KB
- references/orm-guides/overview.md 7.0 KB
- references/pg-migrations/fk-replacement.md 2.9 KB
- references/pg-migrations/index-conversion.md 10 KB
- references/pg-migrations/multi-region.md 2.9 KB
- references/pg-migrations/schema-objects.md 13 KB
- references/pg-migrations/type-mapping.md 4.8 KB
- references/query-plan/catalog-queries.md 8.0 KB
- references/query-plan/guc-experiments.md 7.5 KB
- references/query-plan/plan-interpretation.md 15 KB
- references/query-plan/query-rewrites-dsql-specific.md 900 B
- references/query-plan/query-rewrites-generic.md 1.9 KB
- references/query-plan/query-rewrites/cte-late-materialization.md 1.4 KB
- references/query-plan/query-rewrites/flatten-union-all.md 946 B
- references/query-plan/query-rewrites/left-join-to-inner.md 794 B
- references/query-plan/query-rewrites/not-in-to-not-exists.md 1.4 KB
- references/query-plan/query-rewrites/or-to-in.md 889 B
- references/query-plan/query-rewrites/propagate-filter.md 1.0 KB
- references/query-plan/query-rewrites/push-computation-to-constant.md 1.0 KB
- references/query-plan/query-rewrites/push-group-by-into-subquery.md 1.6 KB
- references/query-plan/query-rewrites/reltuples-estimate.md 1.2 KB
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 300 lines · 227 tokens per session scan A bc2cf436f8da
dsql is a skill published in the GitHub repository awslabs/agent-plugins (876 stars, last pushed 5d ago), licensed Apache-2.0. It adds 227 tokens to every session and 5,294 once invoked, about $0.0011 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
postgresql-indexing
PostgreSQL indexing best practices for Prowler: index design, partial indexes, partitioned table indexing, EXPLAIN ANALYZE validation, concurrent operations, monitoring, and maintenance. Trigger: When creating or modifying PostgreSQL indexes, analyzing query performance with EXPLAIN, debugging slow queries, reviewing…
amazon aurora dsql
Deprecated compatibility redirect for Aurora DSQL guidance. Use when a request concerns DSQL, Aurora DSQL, distributed SQL, DSQL schemas, migrations, queries, authentication, performance, or application development.
azure-resource-manager-postgresql-dotnet
Azure PostgreSQL Flexible Server SDK for .NET. Database management for PostgreSQL Flexible Server deployments. Use for creating servers, databases, firewall rules, configurations, backups, and high availability. Triggers: "PostgreSQL", "PostgreSqlFlexibleServer", "PostgreSQL Flexible Server", "Azure Database for…
clickhouse-managed-postgres-rca
MUST USE when investigating performance issues on a ClickHouse-managed Postgres instance. Provides an evidence-based RCA workflow that scrapes the Prometheus endpoint for system signal, pulls per-digest evidence from the Slow Query Patterns API, and recommends (does not apply) a fix.
redshift-support-specialist
Amazon Redshift domain expertise for query optimization, operational reviews, and cost optimization on provisioned clusters and Serverless workgroups. Use when a user asks about Redshift query tuning, slow queries, disk spill, distribution/sort key issues, a Redshift health check or operational review, or Redshift…
bedrock-adoption-readiness
Amazon Bedrock production readiness assessment covering IAM governance, data retention (ZDR), quota and capacity headroom, and operational observability across Standard Bedrock and Mantle surfaces. Use this skill when a user asks to review Bedrock readiness, assess Bedrock security posture, evaluate quota headroom…