sheets-readonly SKILL.md skillA

sheets-readonly from pipulate/pipulate is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add pipulate/pipulate/sheets-readonly@git:20260928.ccf35a8

Pins git:20260928.ccf35a8 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
pipulate/pipulate
Path
.agents/skills/sheets-readonly/SKILL.md
Versions recorded
1
Latest version
git:20260928.ccf35a8, committed Sep 28, 2026
Size
1,894 bytes
Repository stars
14
License
AGPL-3.0

Read-only Google Sheets access for bounded context pulls. Trigger when a Google Sheets URL or spreadsheet ID needs to become compiled context. Executable truth lives at connectors/sheets.py; this skill is a signpost, never a second implementation.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# sheets_readonly — signpost to connectors/sheets.py

The executable is the specification. Run it; do not reimplement it.

## The three moves

1. Identity and mint (one-time, interactive):
   `python connectors/sheets.py`
   Prints the OAuth wiring status (credentials.json path, its project_id,
   token path) and, in a real terminal, mints ~/.config/pipulate/sheets_token.json
   via the browser handshake. After that, every run is headless.

2. LIST with size gauge:
   `python connectors/sheets.py "<URL-or-ID>"`
   Every tab's rows x cols x ~cells prints BEFORE any fetch; overflow-shaped
   tabs are flagged. A #gid= fragment in a pasted URL selects that tab and
   performs a bounded fetch of it directly.

3. Bounded FETCH:
   `--sheet "<Tab>"` (row-bounded server-side) or `--range "'Tab'!A1:F50"`,
   capped by -n/--max (default 25), `--format tsv|json|markdown` (tsv default).

## Rules inherited from the connector contract

- THE PROBE ECONOMY RULE: read the LIST size gauge before any fetch.
- Client URLs and spreadsheet IDs live in adhoc.txt, never in tracked source.
- Auth is OAuth as YOUR account (gmail.py pattern): no sharing gate, no
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add pipulate/pipulate/sheets-readonly@sha256:a7681bd8e36fbded

The line at the top of this page pins the label git:20260928.ccf35a8, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_g7ke3etjcxl7dohr.svg)](https://markdownregistry.com/a/art_g7ke3etjcxl7dohr)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Sep 28, 2026.

versioncommittedcommitsizeaudit
git:20260928.ccf35a8 latest2026-09-28 ccf35a8 1,894 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (1894 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

pipulate/pipulate · 14 stars · license AGPL-3.0 · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_g7ke3etjcxl7dohr
GET https://markdownregistry.com/api/v1/resolve?ref=pipulate/pipulate/sheets-readonly
GET https://markdownregistry.com/api/v1/blob/a7681bd8e36fbdedcb81a7459beb6b2082ec032735bb9744573be774ae0a8c7f

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from pipulate/pipulate

gsc-readonly SKILL.md skill
pipulate/pipulate · .agents/skills/gsc-readonly/SKILL.md · Read-only Google Search Console access through connectors/gsc.py. Use when a task needs GSC data compiled into context…
git:20260928.ccf35a8 · audit A · 14 stars
hello-workflow SKILL.md skill
pipulate/pipulate · .agents/skills/hello-workflow/SKILL.md · Explains how a Pipulate workflow turns Jupyter Notebook cells into HTMX steps, from the Step namedtuple and the step_xx…
git:20260928.ccf35a8 · audit A · 14 stars
journal SKILL.md skill
pipulate/pipulate · .agents/skills/journal/SKILL.md · The journal behind Pipulate, indexed. More than a thousand dated articles explain why each piece of the machinery…
git:20260928.2818cd4 · audit A · 14 stars
pipulate SKILL.md skill
pipulate/pipulate · .agents/skills/pipulate/SKILL.md · Installing Pipulate, the local-first context compiler, on a machine that does not have it, without taking the keyboard…
git:20260929.c48a334 · audit C · 14 stars
roles SKILL.md skill
pipulate/pipulate · .agents/skills/roles/SKILL.md · Explains the Roles plugin, the homepage and APP-menu control center of Pipulate, including which roles show which…
git:20260928.8fcdcf8 · audit A · 14 stars
AGENTS.md AGENTS.md file
pipulate/pipulate · AGENTS.md
git:20260930.6afd9f7 · audit A · 14 stars

Every file in pipulate/pipulate

Browse by kind, by grade A, or by owner.