{
  "markdown": "# stackql-skills\n\nA [Claude Code](https://claude.ai/code) plugin that adds StackQL-powered skills for querying cloud infrastructure, exploring provider schemas, managing deployments, and more.\n\n## Installation\n\n### From GitHub\n\nAdd the repository as a plugin source and install:\n\n```\n/plugin marketplace add stackql/stackql-skills\n/plugin install stackql-skills@stackql-skills\n```\n\nThis registers the GitHub repo as a marketplace and installs the plugin. Skills will be available as `/stackql-skills:<skill-name>` in all future sessions.\n\n### Updating\n\nTo pull the latest version, update the marketplace first and then the plugin:\n\n```\n/plugin marketplace update stackql-skills\n/plugin update stackql-skills@stackql-skills\n```\n\n## Skills\n\n### `install-stackql`\n\nInstall or update the StackQL CLI. Detects the platform and uses the appropriate package manager or installer.\n\n```\n/stackql-skills:install-stackql\n/stackql-skills:install-stackql --update\n```\n\n### `pull-provider`\n\nPull one or more StackQL providers from the registry. Supports version pinning with `name@version` syntax. Use `--list` to see all available providers.\n\n```\n/stackql-skills:pull-provider google\n/stackql-skills:pull-provider aws azure github\n/stackql-skills:pull-provider okta@v23.03.00121\n/stackql-skills:pull-provider --list\n```\n\n### `query`\n\nRun StackQL queries against cloud and SaaS providers. Accepts raw SQL or natural language questions. Supports SELECT, INSERT, UPDATE, DELETE, and EXEC operations.\n\n```\n/stackql-skills:query SELECT id, status FROM google.compute.instances WHERE project = 'my-project' AND zone = 'us-central1-a'\n/stackql-skills:query \"what EC2 instances are running in us-east-1?\"\n/stackql-skills:query SHOW SERVICES IN aws\n```\n\n### `explore`\n\nNavigate the StackQL provider hierarchy interactively. Discover services, resources, methods, and fields for any provider.\n\n```\n/stackql-skills:explore google\n/stackql-skills:explore google.compute\n/stackql-skills:explore google.compute.instances\n/stackql-skills:explore \"how do I manage S3 buckets?\"\n```\n\n### `stackql-docs`\n\nSearch StackQL documentation, provider registry docs, and blog posts.\n\n```\n/stackql-skills:stackql-docs window functions\n/stackql-skills:stackql-docs \"how do I authenticate with Azure?\"\n/stackql-skills:stackql-docs stackql-deploy manifest format\n```\n\n### `read-memories`\n\nSearch past Claude Code session logs to recover context from previous conversations - decisions made, patterns established, open TODOs.\n\n```\n/stackql-skills:read-memories stackql --here\n```\n\n### `auth-setup`\n\nConfigure authentication for StackQL providers. Walks through credential setup for Google, AWS, Azure, GitHub, and other providers.\n\n```\n/stackql-skills:auth-setup google\n/stackql-skills:auth-setup aws\n/stackql-skills:auth-setup azure\n```\n\n### `notebook`\n\nCreate a complete StackQL Jupyter notebook using the `pystackql` magic commands (`%stackql` / `%%stackql`). Generates setup cells, provider pulls, parameterized queries with `$variable` substitution, and optional visualizations.\n\n```\n/stackql-skills:notebook \"GitHub repo analytics for stackql org\"\n/stackql-skills:notebook google.compute.instances\n/stackql-skills:notebook \"AWS S3 bucket inventory\" --server\n```\n\nRequires `pystackql` (`pip install pystackql`).\n\n### `notebook-cell`\n\nAdd StackQL query cells to an existing pystackql notebook. Creates a markdown heading cell, a `%%stackql` query cell, and an optional visualization cell.\n\n```\n/stackql-skills:notebook-cell \"show all running instances by zone\"\n/stackql-skills:notebook-cell \"SELECT name, status FROM google.compute.instances WHERE project = '$project' AND zone = '$zone'\" --viz bar\n```\n\n### `scaffold-stack`\n\nGenerate a stackql-deploy stack with a `stackql_manifest.yml` and `.iql` resource files for provisioning cloud infrastructure.\n\n```\n/stackql-skills:scaffold-stack \"VPC with two subnets in Google Cloud\"\n/stackql-skills:scaffold-stack google.compute.networks\n```\n\n### `setup-ci`\n\nGenerate CI/CD pipeline configuration for stackql-deploy stacks. Creates workflows for build, test, and teardown.\n\n```\n/stackql-skills:setup-ci\n/stackql-skills:setup-ci --provider github-actions --stack my-network\n```\n\n## Local development\n\nTo test skills locally from a clone of this repo:\n\n```bash\n# 1. Clone the repo\ngit clone https://github.com/stackql/stackql-skills.git\ncd stackql-skills\n\n# 2. Launch Claude Code with the local plugin directory\nclaude --plugin-dir .\n```\n\nThis loads the plugin from disk instead of the marketplace, so any edits to `skills/*/SKILL.md` take effect immediately - just start a new conversation (or re-run the slash command) to pick up changes.\n\nYou can test individual skills directly:\n\n```\n/stackql-skills:explore google\n/stackql-skills:query SHOW PROVIDERS\n/stackql-skills:stackql-docs authentication\n```\n\n**Prerequisites:** StackQL CLI must be installed. If it isn't, the skills will offer to install it via `/stackql-skills:install-stackql`.\n\n## How the skills work together\n\nSkills reference each other where it makes sense:\n\n- `query`, `explore`, and `auth-setup` all check for StackQL installation and delegate to `install-stackql` if needed\n- `query` and `explore` check for pulled providers and delegate to `pull-provider`\n- `query` checks for auth and delegates to `auth-setup` when credentials are missing\n- `notebook` uses `explore` patterns to discover schemas and generates `pystackql` magic cells\n- `notebook-cell` reads existing notebooks to understand context (variables, providers) before adding cells\n- `scaffold-stack` uses `explore` patterns to discover resource schemas\n- `setup-ci` reads `stackql_manifest.yml` created by `scaffold-stack`\n- All skills use `stackql-docs` for error troubleshooting\n\n## Platform support\n\nThese skills work on **macOS**, **Linux**, and **Windows**. The StackQL CLI supports all three platforms.\n\n## Reporting issues and suggestions\n\nFound a bug or have an idea for improvement? Open an issue at:\n\n**https://github.com/stackql/stackql-skills/issues**\n\nFor StackQL-specific bugs (provider issues, SQL errors), please include the StackQL version (`stackql --version`) and the full error message.\n",
  "bytes": 6145,
  "sha": "608f0b5ef5df5509357bd5fb0a005c3296b785cbedc9490915e6b4d2213a177e",
  "repo_slug": "stackql/stackql-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_stackql_stackql_skills_stackql_skills_01acf507/readme"
}