openproject-core

What problem does it solve?

This skill provides a reusable OpenProject API v3 client and utilities to simplify building integrations with OpenProject instances, reducing boilerplate and enabling reliable API interactions.

Core Features & Use Cases

• OpenProjectClient: a Python HTTP client with built-in API key authentication, HAL+JSON parsing, and error handling.
• Helper utilities: build_filters(), build_sort(), paginate(), and extract_id_from_href() to simplify common API patterns.
• HAL type definitions and error classes to standardize responses and exceptions.
• Project configuration helpers: init_config(), load_config(), refresh_config(), require_config(), and print_config_summary() to cache project metadata and speed up repeated lookups.
• Use cases: integrate external tooling to fetch projects, members, statuses, and work packages, then render dashboards or drive automated workflows.

Quick Start

Navigate to the skill directory and run a Claude session, e.g. uv run python code using the openproject_core module:

• cd .claude/skills/openproject/openproject-core
• uv run python -c "from openproject_core import OpenProjectClient; client = OpenProjectClient(base_url='https://your-openproject-instance', api_key='your-key'); print(client.check_connection())"