OpenParable
Skip to content
← Back to skills

Missing Signatures

Productivity
missing-signatures

Missing Signatures is an Agent Skill for productivity published in the getprobo/probo repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Report who is missing document signatures or quorum approvals in Probo. Use when the user wants a per-person recap of unsigned signature requests, pending approval decisions, or document signing compliance status.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/getprobo/probo/blob/HEAD/packages/skills/skills/missing-signatures/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/missing-signatures, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Missing signatures report

Build a read-only, per-person recap of outstanding document obligations for organization $ARGUMENTS (or ask the user for the organization name). Cover:

  1. Signature requests — REQUESTED but not SIGNED on a published version
  2. Quorum approvals — PENDING decisions on a PENDING approval quorum while the version is PENDING_APPROVAL

Before executing, read these files relative to this skill directory:

  • references/mcp-tools.md — MCP tool names, inputs, pagination
  • references/report-format.md — per-person recap and summary layout
  • references/notes-format.md — working memory for resumable scans

Preconditions

  1. Probo MCP must be connected. If tools fail with auth errors, stop and tell the user to complete OAuth sign-in for the Probo MCP server in their agent (Claude Code: /mcp or claude mcp login probo; Codex: codex mcp login probo; OpenCode/Cursor: configure MCP in settings then authenticate).
  2. Resolve the organization from $ARGUMENTS (name match or GID). If ambiguous, call listOrganizations and ask the user to pick one.
  3. This skill is reporting only. Do not request signatures, cancel requests, publish documents, or submit approval decisions unless the user explicitly asks for follow-up actions outside this report.

Working notes file

Create or resume .probo/missing-signatures/<org-slug>.md per references/notes-format.md. Create .probo/missing-signatures/ if missing.

Workflow

1. Orient

  • Record organization_id in the notes file.
  • If resuming, read last_document_cursor and cached profile_cache from notes.
  • Tell the user whether this is a fresh scan or a resume.

2. Scan documents (paginated)

For each page from listDocuments:

  • Skip ARCHIVED documents.
  • Call listDocumentVersions for the document.
  • For each version, branch on status:
Version statusWhat to check
PUBLISHEDlistDocumentVersionSignatures with filter.states: ["REQUESTED"]
PENDING_APPROVALlistDocumentVersionApprovalQuorums; for each quorum with status: PENDING, listDocumentVersionApprovalDecisions with filter.states: ["PENDING"]

Prefer the current published version (current_published_major / current_published_minor on the document) when multiple published minors exist. Still scan all PUBLISHED versions if the user asked for exhaustive coverage.

Paginate every list call. Store last_document_cursor after each document page so a large org can be resumed.

3. Resolve people

Collect unique signed_by and approver_id profile GIDs. Resolve each once via getUser and cache full_name and email_address in the notes file. Never invent names.

4. Build per-person recap

Aggregate findings by profile. Each item is either:

TypeMeaning
signatureSignature requested, not yet signed
approvalQuorum approval decision still pending

Use references/report-format.md for the output layout. Sort people by full_name, then email.

5. Present summary

Show:

  • Total people with at least one outstanding item
  • Count by type (signatures vs approvals)
  • Count by document
  • The per-person recap tables

If the scan is incomplete (more document pages), say so and offer to continue.

6. Checkpoint

Update notes: last_document_cursor, profile_cache, session log, updated_at. Clear last_document_cursor when the document pagination is exhausted.

Hard rules

  • Never call write mutations (requestDocumentVersionSignature, cancelSignatureRequest, publishDocument, voidDocumentVersionApproval) unless the user explicitly requests action after reviewing the report.
  • Never invent profile IDs, document titles, or states — use MCP responses only.
  • Include document title, version (major.minor), and requested_at or quorum created_at on every line item so the report is audit-ready.