Agent skill

Calcpad API Developer

by imartincei in imartincei/CalcpadCE

Expert developer for PyCalcpad (Calcpad.Api) - the programmatic API wrapper for Calcpad.

MITAuto-check: notesBackend & APIs

Install Calcpad API Developer

skills CLI
$ npx skills add imartincei/CalcpadCE --skill calcpad-api-developer -a claude-code

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

GitHub CLI
$ gh skill install imartincei/CalcpadCE calcpad-api-developer --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/imartincei/CalcpadCE.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/calcpad-api-developer .claude/skills/calcpad-api-developer && 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
calcpad-api-developer
GitHub stars
110
Token cost
~1.1k tokens
SKILL.md length
385 words
Files
2
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

Expert developer for PyCalcpad (Calcpad.Api) - the programmatic API wrapper for Calcpad.

  • Works in 6 steps: Simplicity First - Common tasks should… → Progressive Disclosure - Simple API for… → Consistent Naming - Match Calcpad… → …
  • Working on the API layer
  • SKILL.md covers Core Capabilities, Reference Files, Solution Context and Project Structure, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Calcpad API Developer is an agent skill from imartincei/CalcpadCE. Expert developer for PyCalcpad (Calcpad.Api) - the programmatic API wrapper for Calcpad. Use when working on the API layer, Calculator class, Parser, Settings, or Converter in the Calcpad.Api project.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `reference/api-surface.md`).

It sits in Backend & APIs, covering Third-party API integration. The repository describes itself as: Calcpad Community Edition. The licence is MIT.

When your agent uses it

  • Working on the API layer
  • Calculator class
  • Converter in the Calcpad.Api project

Example prompts

  • “/calcpad-api-developer”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): Read, Write, Edit, Glob, Grep, Bash

Workflow steps

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

  1. Simplicity First - Common tasks should be one-liners
  2. Progressive Disclosure - Simple API for basic use, advanced for power users
  3. Consistent Naming - Match Calcpad terminology
  4. Strong Typing - Use proper types, not just strings
  5. Null Safety - Handle missing values gracefully
  6. Documentation - XML comments on all public members

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Glob
    • Grep
    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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

Calcpad API Developer loads about 1.1k tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 385 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Edit, Glob, Grep, Bash

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 imartincei/CalcpadCE at commit 0b20dba, republished under its MIT licence (© imartincei). 385 words, ~1,130 tokens.

Download SKILL.mdSave it as .claude/skills/calcpad-api-developer/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
calcpad-api-developer
description
Expert developer for PyCalcpad (Calcpad.Api) - the programmatic API wrapper for Calcpad. Use when working on the API layer, Calculator class, Parser, Settings, or Converter in the Calcpad.Api project.
allowed-tools
Read, Write, Edit, Glob, Grep, Bash

Calcpad API Developer

Expert agent for developing PyCalcpad (Calcpad.Api) - the programmatic API wrapper for Calcpad.

You are an expert C# developer specializing in API design and library development. You understand the PyCalcpad wrapper architecture, how it exposes Calcpad.Core functionality, and best practices for creating clean, usable APIs.

Core Capabilities

  • Design and implement public API surfaces
  • Wrap Calcpad.Core functionality
  • Create configuration and settings classes
  • Handle data type conversions
  • Document API usage
  • Ensure API consistency and usability

Reference Files

Read reference/api-surface.md for the full public API: Calculator/Parser/Settings/Converter class listings, usage examples, error handling, Core integration internals, and test examples.

Solution Context

Project Dependency Graph
Calcpad.Cli (Command Line)
├── Calcpad.Core
├── Calcpad.OpenXml
└── PyCalcpad  ← YOU ARE HERE
    ├── Calcpad.Core
    └── Calcpad.OpenXml
ProjectPurposeIntegration Notes
Calcpad.CoreMath engineSource of all calculation functionality
Calcpad.OpenXmlExportUsed for document generation
Calcpad.CliCLI consumerPrimary consumer of PyCalcpad API

Project Structure

Calcpad.Api/
├── PyCalcpad/
│   ├── Calculator.cs      # Expression evaluation (wraps MathParser)
│   ├── Parser.cs          # Document parsing + file conversion (wraps ExpressionParser)
│   ├── Reader.cs          # internal — file reading, #include, highlighted-source fallback
│   ├── Converter.cs       # internal — HtmlResult → html/docx/pdf output
│   ├── Settings.cs        # Settings { Math, Plot, Units }
│   ├── MathSettings.cs    # Math settings + TrigUnits enum
│   ├── PlotSettings.cs    # Plot settings + ColorScales / LightDirections enums
│   ├── Program.cs         # Console entry point; Program.AppPath anchors doc/ assets
│   ├── zip.cs             # Archive helper
│   ├── doc/, Fonts/       # HTML worksheet template and bundled fonts
│   └── PyCalcpad.csproj
└── PyCalcpad*.py          # Python-side samples (Convert, Eval, Parse, Run, Wrapper)

Public API (summary)

  • Calculator — expression level: Calculator(MathSettings), Eval, Run, SetVariable
  • Parser — document level: Settings field, Parse (→ HTML), Convert (file → html/docx/pdf)
  • Settings / MathSettings / PlotSettings — plain settings objects, converted to their Calcpad.Core counterparts at the boundary

Converter and Reader are internal — they serve Parser.Convert, not consumers.

Full signatures, usage examples, and Core integration are in reference/api-surface.md.

API Design Guidelines

  1. Simplicity First - Common tasks should be one-liners
  2. Progressive Disclosure - Simple API for basic use, advanced for power users
  3. Consistent Naming - Match Calcpad terminology
  4. Strong Typing - Use proper types, not just strings
  5. Null Safety - Handle missing values gracefully
  6. Documentation - XML comments on all public members
Show full SKILL.md (146 more words)Show less

Extending the API

Adding a New API Method
  1. Identify the Core functionality
  2. Create the wrapper method with XML documentation
  3. Add to the appropriate class
Adding a Setting

A new setting must land in three places or it is silently ignored: the PyCalcpad settings class, the Convert*Settings mapper in Calculator.cs / Parser.cs, and the Calcpad.Core counterpart.

Adding a New Settings Class

Follow the pattern of MathSettings / PlotSettings with sensible defaults and XML docs.

Workflow

  1. Design the API surface - What should consumers call?
  2. Find Core functionality - What does Calcpad.Core provide?
  3. Load reference/api-surface.md for existing patterns and Core integration
  4. Create the wrapper - Simple, documented, error-handled
  5. Add settings if needed - Configuration for advanced use
  6. Verify behavior - There is no test project for PyCalcpad; exercise it through the Python samples (PyCalcpadEval.py, PyCalcpadConvert.py, ...) or a scratch console call
  7. Document - XML comments and examples

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

Files

SKILL.md and 1 other file in .claude/skills/calcpad-api-developer of imartincei/CalcpadCE.

  • SKILL.md
  • reference/api-surface.md

Open the folder on GitHubat commit 0b20dba

Compare with similar skills

Calcpad API Developer 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.

Calcpad API Developer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Calcpad API Developer this skillimartincei/CalcpadCE110—~1.1kAutomated safety check: NotesMIT
Sub2API AdminWei-Shaw/sub2api43k1 repos~717Automated safety check: PassLGPL-3.0
Firecrawl Build Onboardingfirecrawl/firecrawl190k1 repos~1.4kAutomated safety check: NotesISC
ToolJet Marketplace Plugin BuilderToolJet/ToolJet41k—~2.1kAutomated safety check: PassAGPL-3.0
Firecrawl Search Integrationfirecrawl/firecrawl190k1 repos~1.1kAutomated safety check: PassISC
CoinGecko API Reference2025Emma/vibe-coding-cn23k2 repos~646Automated safety check: PassMIT

Similar skills

  • Sub2API Admin

    Wei-Shaw/sub2api

    Manages a Sub2API deployment from the command line: accounts, redeem and invitation codes, groups, proxies, imports, exports and raw admin API calls.

    43k GitHub starsUsed in 1 repo~717 tokens
    Backend & APIsAuto-check passed
  • Firecrawl Build Onboarding

    firecrawl/firecrawl

    Gets Firecrawl working in a project: signs you in through the browser, saves FIRECRAWL_API_KEY to .env and picks the first SDK or REST path.

    190k GitHub starsUsed in 1 repo~1.4k tokens
    Backend & APIsAuto-check: notes
  • Turns an API description, such as an OpenAPI file or a Postman collection, into a connector plugin for ToolJet's marketplace and checks it with the repo's validator.

    41k GitHub stars~2.1k tokensUpdated today
    Backend & APIsAuto-check passed
  • Firecrawl Search Integration

    firecrawl/firecrawl

    Guidance for adding Firecrawl's /search endpoint to product code and agent workflows when a feature starts from a query rather than a URL.

    190k GitHub starsUsed in 1 repo~1.1k tokens
    Backend & APIsAuto-check passed
  • CoinGecko API Reference

    2025Emma/vibe-coding-cn

    CoinGecko API documentation - cryptocurrency market data API, price feeds, market cap, volume, historical data. Use when integrating CoinGecko API, building…

    23k GitHub starsUsed in 2 repos~646 tokens
    Backend & APIsAuto-check passed
  • NEAR Intents Swap Integration

    internet-court/internet-court-skill

    Builds cross-chain token swaps and bridge flows with the NEAR Intents 1Click API: quotes, deposit addresses, per-chain deposits and status polling.

    6.4k GitHub starsUsed in 2 repos~939 tokens
    Backend & APIsAuto-check passed

More from imartincei/CalcpadCE

  • Calcpad Core Developer

    imartincei/CalcpadCE

    Expert developer for Calcpad.Core - the mathematical parsing and calculation engine.

    110 GitHub stars~840 tokensUpdated today
    Auto-check: notes
  • Calcpad Highlighter Developer

    imartincei/CalcpadCE

    Expert developer for Calcpad.Highlighter - tokenization, linting, content resolution, and language tooling.

    110 GitHub stars~1k tokensUpdated today
    Auto-check: notes
  • Calcpad Web Backend Developer

    imartincei/CalcpadCE

    Expert developer for Calcpad.Web/backend - the ASP.NET Core 10 Web API server.

    110 GitHub stars~1.4k tokensUpdated today
    Auto-check: notes
  • Calcpad Web Frontend Developer

    imartincei/CalcpadCE

    Expert developer for Calcpad.Web/frontend - the TypeScript/Vue 3 frontend monorepo.

    110 GitHub stars~1.1k tokensUpdated today
    Auto-check: notes
  • Calcpad Generator

    imartincei/CalcpadCE

    Generate Calcpad (.cpd) files for mathematical and engineering calculations.

    110 GitHub stars~656 tokensUpdated today
    Auto-check passed

Categories

Questions about Calcpad API Developer

What does Calcpad API Developer do?

Expert developer for PyCalcpad (Calcpad.Api) - the programmatic API wrapper for Calcpad. Calcpad API Developer is an agent skill from imartincei/CalcpadCE.Api) - the programmatic API wrapper for Calcpad.

When should I use Calcpad API Developer?

Calcpad API Developer fits situations like: working on the API layer; calculator class; converter in the Calcpad.Api project.

How do I install Calcpad API Developer in Claude Code?

Run `npx skills add imartincei/CalcpadCE --skill calcpad-api-developer -a claude-code`. Or copy the skill folder (.claude/skills/calcpad-api-developer in imartincei/CalcpadCE) into .claude/skills/calcpad-api-developer in your project. Claude Code loads it when a task matches its description.

How do I install Calcpad API Developer in Codex?

Run `npx skills add imartincei/CalcpadCE --skill calcpad-api-developer -a codex`. Or copy the skill folder (.claude/skills/calcpad-api-developer in imartincei/CalcpadCE) into .agents/skills/calcpad-api-developer in your project. Codex loads it when a task matches its description.

Can I use Calcpad API Developer 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 imartincei/CalcpadCE --skill calcpad-api-developer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/calcpad-api-developer, .gemini/skills/calcpad-api-developer, .github/skills/calcpad-api-developer and .opencode/skills/calcpad-api-developer in your project.

What does Calcpad API Developer need to run?

SKILL.md names no scripts, command-line tools or credentials: Calcpad API Developer is instructions for the agent only. Our summary lists: Python 3. Its frontmatter pre-approves these tools: Read, Write, Edit, Glob, Grep, Bash.

Does Calcpad API Developer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Calcpad API Developer safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Calcpad API Developer use?

Calcpad API Developer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Calcpad API Developer use?

About 1.1k tokens (SKILL.md is roughly 4.5k 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 Calcpad API Developer?

Skills that share tags, products or a category with Calcpad API Developer: Sub2API Admin (Wei-Shaw/sub2api, 43k stars), Firecrawl Build Onboarding (firecrawl/firecrawl, 190k stars), ToolJet Marketplace Plugin Builder (ToolJet/ToolJet, 41k stars) and Firecrawl Search Integration (firecrawl/firecrawl, 190k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Calcpad API Developer?

imartincei (a GitHub user) maintains it in imartincei/CalcpadCE, which has 110 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 7, 2026.

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