Freshservice skill for Claude: tickets, assets, people, changes/problems/releases

Stdlib-only fs.py helper wrapping the Freshservice REST API v2 (auth, URL
building, filter quoting, pagination, error surfacing), plus SKILL.md and a
reference of endpoints, status/priority codes, and filter-query syntax.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

README.md

@@ -0,0 +1,51 @@
+# freshservice-claude
+
+A [Claude](https://claude.com/claude-code) **skill** for working with
+[Freshservice](https://www.freshservice.com/) ITSM from chat / Cowork — view,
+create, update, reply to, and triage tickets; look up and update assets/CMDB;
+find agents, requesters, groups, and departments; and manage changes, problems,
+and releases via the Freshservice REST API v2.
+
+## Layout
+
+| File | Purpose |
+|------|---------|
+| `SKILL.md` | Skill entry point — setup, common commands, guardrails |
+| `reference.md` | Endpoints, status/priority codes, filter-query syntax |
+| `scripts/fs.py` | Stdlib-only API helper (auth, URL building, paging, errors) |
+
+## Install
+
+Copy the skill into your Claude skills directory:
+
+```bash
+cp -R . ~/.claude/skills/freshservice
+```
+
+## Configure credentials
+
+```bash
+mkdir -p ~/.freshservice
+cat > ~/.freshservice/credentials <<'EOF'
+FRESHSERVICE_DOMAIN=yourcompany
+FRESHSERVICE_API_KEY=your_api_key
+EOF
+chmod 600 ~/.freshservice/credentials
+
+python3 ~/.claude/skills/freshservice/scripts/fs.py check
+```
+
+The API key is in Freshservice → profile picture → *Profile settings* → API key.
+`FRESHSERVICE_DOMAIN` accepts the subdomain (`yourcompany`) or the full host.
+Environment variables of the same name override the file.
+
+## Usage
+
+The skill activates when you mention Freshservice or a ticket/asset/change in
+chat. Under the hood it calls:
+
+```bash
+python3 scripts/fs.py request <METHOD> <PATH> [--param KEY=VALUE ...] [--data '<JSON>']
+```
+
+See `SKILL.md` and `reference.md` for details.