New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Take Doc Screenshots

by pgplex in pgplex/pgconsole

Take screenshots of the running pgconsole app for documentation.

Apache-2.0Auto-check passedDatabases

Install Take Doc Screenshots

skills CLI
$ npx skills add pgplex/pgconsole --skill take-doc-screenshots -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pgplex/pgconsole take-doc-screenshots --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pgplex/pgconsole.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/take-doc-screenshots .claude/skills/take-doc-screenshots && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
take-doc-screenshots
GitHub stars
155
Token cost
~841 tokens
SKILL.md length
329 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
Apache-2.0

At a glance

Take screenshots of the running pgconsole app for documentation.

  • Works in 4 steps: Read pgconsole.toml to find the email… → Call the login API to get a session token → Extract the pgconsole_token cookie value… → …
  • Updating docs with screenshots
  • SKILL.md covers Prerequisites, Authentication, Taking Screenshots and Image Processing, plus 1 more section
  • Calls curl, pnpm and pipx

What it does

Take Doc Screenshots is an agent skill from pgplex/pgconsole. Take screenshots of the running pgconsole app for documentation. Use when updating docs with screenshots or adding images to .mdx files.

Its SKILL.md is about 840 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Databases, covering Markdown. It works with PostgreSQL, SQL, Model Context Protocol and Supabase. The repository describes itself as: Minimal Postgres editor for speed, collaboration, and AI. The licence is Apache-2.0.

When your agent uses it

  • Updating docs with screenshots
  • Adding images to .mdx files

Example prompts

  • “/take-doc-screenshots”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Read pgconsole.toml to find the email and password from the first [[users]] entry
  2. Call the login API to get a session token
  3. Extract the pgconsole_token cookie value from cookies.txt
  4. Create a Playwright auth state JSON file

What it can do on your machine

Read from SKILL.md and the folder at commit bf166f0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • pnpm
    • pipx
    • brew

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use curl, pnpm and pipx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Take Doc Screenshots loads about 841 tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 329 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~39
When it runs · the whole SKILL.md, loaded when a task matches
~841

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from pgplex/pgconsole at commit bf166f0, republished under its Apache-2.0 licence (© pgplex). 329 words, ~841 tokens.

Download SKILL.mdSave it as .claude/skills/take-doc-screenshots/SKILL.md (or your agent's skills folder).
name
take-doc-screenshots
description
Take screenshots of the running pgconsole app for documentation. Use when updating docs with screenshots or adding images to .mdx files.
disable-model-invocation
false
argument-hint
page-or-feature

Take Documentation Screenshots

Capture screenshots of the running pgconsole app at http://localhost:5173 for use in documentation.

Prerequisites

  • The dev server must be running (pnpm dev)
  • shot-scraper must be installed (pipx install shot-scraper && shot-scraper install)
  • cwebp must be installed (brew install webp)

Authentication

Login credentials are in pgconsole.toml under [[users]]. Use the first user entry.

  1. Read pgconsole.toml to find the email and password from the first [[users]] entry
  2. Call the login API to get a session token:
    curl -s -c cookies.txt -X POST http://localhost:5173/api/auth/login \
  -H 'Content-Type: application/json' \
  -d '{"email":"<email>","password":"<password>"}'
  3. Extract the pgconsole_token cookie value from cookies.txt
  4. Create a Playwright auth state JSON file:
    json
    {
  "cookies": [{
    "name": "pgconsole_token",
    "value": "<token>",
    "domain": "localhost",
    "path": "/",
    "httpOnly": true,
    "secure": false,
    "sameSite": "Lax"
  }],
  "origins": []
}

Taking Screenshots

Write a Playwright script (.mjs file in the scratchpad directory) that:

  1. Launches Chromium with viewport: { width: 1440, height: 900 } (no deviceScaleFactor — use 1x)
  2. Sets the auth cookie via context.addCookies()
  3. Navigates to http://localhost:5173
  4. Uses Playwright actions (click, type, keyboard) to navigate to the desired state
  5. Saves screenshots as PNG
CodeMirror Interaction

The SQL editor uses CodeMirror 6. To type into it:

  • Click .cm-content to focus
  • Use page.keyboard.type('SQL here', { delay: 5 }) to type
  • Use page.keyboard.press('Control+Space') for autocomplete
  • Use page.keyboard.press('Meta+a') to select all before replacing content
  • Do NOT try to access cmView from the DOM — it's not exposed
Show full SKILL.md (133 more words)Show less
UI Navigation

Key buttons to interact with:

  • button with text SQL — opens a new query tab
  • button with text Run — executes the query
  • button with text Format — opens format dropdown
  • button with text Quick SQL — opens quick SQL dropdown
  • button with text Processes — opens processes modal
  • Right-click on .cm-content for context menu
Dismissing Overlays

After capturing dropdown/modal screenshots, always dismiss with:

js
await page.keyboard.press('Escape');
await page.waitForTimeout(500);

An open overlay blocks clicks on other elements.

Image Processing

  1. Convert PNGs to WebP: cwebp -q 90 input.png -o output.webp
  2. Store in docs/images/features/<feature-name>/ (matching docs/features/<feature-name>.mdx)
  3. Reference in MDX as ![Alt text](/images/features/<feature-name>/<image>.webp)
  4. Clean up temporary PNG files after conversion

Image Convention

  • Format: WebP (.webp), quality 90
  • Dimensions: 1440x900 (1x resolution)
  • Location: docs/images/ mirroring the docs/ structure
  • Naming: <feature>-<description>.webp (e.g., sql-editor-autocomplete.webp)
  • Alt text: brief description of what the screenshot shows

© pgplex, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/take-doc-screenshots of pgplex/pgconsole.

Open the folder on GitHubat commit bf166f0

Compare with similar skills

Take Doc Screenshots next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Take Doc Screenshots compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Take Doc Screenshots this skillpgplex/pgconsole155—~841Automated safety check: PassApache-2.0
Alloydb Basicsgoogle/skills21k—~1.7kAutomated safety check: PassApache-2.0
NubaseOtterMind/Nubase623—~2.2kAutomated safety check: NotesApache-2.0
Clickhouse Logs Queriessupabase/supabase111k—~2.4kAutomated safety check: PassApache-2.0
Safe SQL Executionsupabase/supabase111k—~4.2kAutomated safety check: PassApache-2.0
Schema Explorationtimescale/pg-aiguide1.9k—~1.1kAutomated safety check: PassApache-2.0

Similar skills

  • Alloydb Basics

    google/skills

    Official

    Manages clusters, instances, and backups for AlloyDB for PostgreSQL, and integrates with AlloyDB Model Context Protocol (MCP) tools for automated database operations.

    21k GitHub stars~1.7k tokensUpdated today
    DatabasesAuto-check passed

  • Nubase

    OtterMind/Nubase

    A skill your agent uses when the user mentions Nubase broadly, wants a backend for an AI-generated app, or needs to deploy/publish generated code online — across Database, Auth, Storage, Assets…

    623 GitHub stars~2.2k tokensUpdated 9 days ago
    Backend & APIsAuto-check: notes

  • Clickhouse Logs Queries

    supabase/supabase

    Official

    Write, review, and migrate Supabase logs queries against the ClickHouse-backed logs table (the logs.all.otel analytics endpoint).

    111k GitHub stars~2.4k tokensUpdated today
    DatabasesAuto-check passed

  • Safe SQL Execution

    supabase/supabase

    Official

    A skill your agent uses whenever code will build, return, fetch, or execute SQL that runs against a user's real Postgres database — even when the request reads like an ordinary feature or bug fix…

    111k GitHub stars~4.2k tokensUpdated today
    DatabasesAuto-check passed

  • Schema Exploration

    timescale/pg-aiguide

    Explore an existing PostgreSQL database before answering questions about its data or writing SQL.

    1.9k GitHub stars~1.1k tokensUpdated today
    DatabasesAuto-check passed

  • Npgsqlrest

    NpgsqlRest/NpgsqlRest

    Build and modify REST APIs with NpgsqlRest — exposing PostgreSQL as HTTP endpoints from two sources (database functions/procedures/tables/views, and plain .sql files), driven by SQL comment…

    132 GitHub stars~7k tokensUpdated 5 days ago
    DatabasesAuto-check: notes

More from pgplex/pgconsole

  • PR Bot Reviews

    pgplex/pgconsole

    Triage, verdict, and reply to automated PR review comments from GitHub Copilot and Greptile, then iterate until the bots have nothing left to say.

    155 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Categories

Questions about Take Doc Screenshots

What does Take Doc Screenshots do?

Take screenshots of the running pgconsole app for documentation. Take Doc Screenshots is an agent skill from pgplex/pgconsole. Take screenshots of the running pgconsole app for documentation.

When should I use Take Doc Screenshots?

Take Doc Screenshots fits situations like: updating docs with screenshots; adding images to .mdx files.

How do I install Take Doc Screenshots in Claude Code?

Run `npx skills add pgplex/pgconsole --skill take-doc-screenshots -a claude-code`. Or copy the skill folder (.claude/skills/take-doc-screenshots in pgplex/pgconsole) into .claude/skills/take-doc-screenshots in your project. Claude Code loads it when a task matches its description.

How do I install Take Doc Screenshots in Codex?

Run `npx skills add pgplex/pgconsole --skill take-doc-screenshots -a codex`. Or copy the skill folder (.claude/skills/take-doc-screenshots in pgplex/pgconsole) into .agents/skills/take-doc-screenshots in your project. Codex loads it when a task matches its description.

Can I use Take Doc Screenshots in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pgplex/pgconsole --skill take-doc-screenshots -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/take-doc-screenshots, .gemini/skills/take-doc-screenshots, .github/skills/take-doc-screenshots and .opencode/skills/take-doc-screenshots in your project.

What does Take Doc Screenshots need to run?

Going by SKILL.md and its folder, Take Doc Screenshots needs the command-line tools its instructions call (curl, pnpm, pipx and brew).

Does Take Doc Screenshots access the network?

SKILL.md contains no URLs. Its commands use curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Take Doc Screenshots safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Take Doc Screenshots use?

Take Doc Screenshots is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Take Doc Screenshots use?

About 841 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Take Doc Screenshots?

Skills that share tags, products or a category with Take Doc Screenshots: Alloydb Basics (google/skills, 21k stars), Nubase (OtterMind/Nubase, 623 stars), Clickhouse Logs Queries (supabase/supabase, 111k stars) and Safe SQL Execution (supabase/supabase, 111k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Take Doc Screenshots?

pgplex (a GitHub organization) maintains it in pgplex/pgconsole, which has 155 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on August 14, 2026.

Source: pgplex/pgconsole on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.