Skip to content

Add endpoints skill for document management API#304

Open
adamkristopher wants to merge 2 commits into
anthropics:mainfrom
adamkristopher:add-endpoints-skill
Open

Add endpoints skill for document management API#304
adamkristopher wants to merge 2 commits into
anthropics:mainfrom
adamkristopher:add-endpoints-skill

Conversation

@adamkristopher

Copy link
Copy Markdown

Summary

Adds a skill for interacting with the Endpoints document management platform - a SaaS tool that uses AI to extract and organize structured data from documents.

Features

This skill enables Claude to:

  • List endpoints - View all endpoints organized by category
  • Inspect - Get detailed metadata for specific endpoints
  • Scan - Upload files/text for AI extraction
  • Create/Delete - Manage endpoints programmatically
  • Delete items - Remove individual metadata items by ID
  • Stats - Check usage and billing statistics

Files Included

  • SKILL.md - Main skill instructions with quick reference commands
  • scripts/endpoints.sh - Helper bash script for simplified API calls
  • references/api-reference.md - Comprehensive API documentation

Configuration

Requires two environment variables:

  • ENDPOINTS_API_URL - Base API URL (e.g., https://endpoints.work)
  • ENDPOINTS_API_KEY - API key with ep_ prefix

Example Usage

# List all endpoints
/endpoints overview

# Scan a document
/endpoints scan-file ./resume.pdf "job tracker"

# Inspect endpoint
/endpoints inspect /job-tracker/january

Test plan

  • Verify SKILL.md parses correctly (frontmatter + markdown)
  • Test helper script with valid/invalid environment variables
  • Confirm skill appears in Claude Code skill list
  • Test each command (overview, inspect, scan-text, scan-file, delete, stats)

Generated with Claude Code

adamkristopher and others added 2 commits January 28, 2026 22:25
Adds a skill for interacting with the Endpoints document management platform.
This skill enables Claude to:
- List all endpoints organized by category
- Inspect endpoint details and metadata
- Scan files and text with AI extraction
- Create and delete endpoints
- Delete individual items by ID
- Check usage statistics

Includes:
- SKILL.md with frontmatter and quick reference
- Helper bash script (endpoints.sh) for simplified commands
- Comprehensive API reference documentation

Requires ENDPOINTS_API_URL and ENDPOINTS_API_KEY environment variables.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Document how the prompt parameter controls endpoint routing:
- "category name" creates new endpoint with AI-generated slug
- "category - slug" adds items to existing endpoint

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant