{
  "markdown": "# ResultKit Skills\n\nAI coding agent skills for the [ResultMaps](https://resultmaps.com) V2 API. Manage your day plans, team boards, weekly meetings, and action items directly from the command line.\n\nWorks with **Claude Code**, **OpenAI Codex CLI**, and **Google Gemini CLI**.\n\n## What's Included\n\n| Skill | Description |\n|-------|-------------|\n| `rkit:setup` | First-run configuration. Sets up API token, default team, and base URL. |\n| `rkit:today` | View and manage your day plan. Add, complete, and remove action items. |\n| `rkit:board` | View any item as a board. Columns are children, items are grandchildren. |\n| `rkit:weekly` | Team weekly board with framework-aware terminology (EOS, OKR, 4DX, etc.). |\n| `rkit:braindump` | Parse unstructured text (meeting notes, emails, dictation) into organized action items. |\n\n## Prerequisites\n\n- A ResultMaps account with an API token ([get one here](https://resultmaps.com))\n- `curl` and `jq` available in your shell\n- One of the supported AI coding agents (see installation below)\n\n---\n\n## Installation\n\n### Claude Code\n\nRequires [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI.\n\n**Install via plugin marketplace (recommended):**\n\n```\n/plugin marketplace add w3mg/resultkit-skills\n/plugin install rkit@resultkit\n```\n\n**Update to latest:**\n\n```\n/plugin marketplace update\n```\n\nThen run `/rkit:setup` to configure your API token and default team.\n\n### OpenAI Codex CLI\n\nRequires [Codex CLI](https://github.com/openai/codex).\n\n**Install skills:**\n\n```bash\ngit clone https://github.com/w3mg/resultkit-skills.git\nmkdir -p ~/.agents/skills\ncp -r resultkit-skills/skills/* ~/.agents/skills/\n```\n\n**Update to latest:**\n\n```bash\ncd resultkit-skills && git pull\ncp -r skills/* ~/.agents/skills/\n```\n\nThen run `$rkit:setup` to configure your API token and default team.\n\n### Google Gemini CLI\n\nRequires [Gemini CLI](https://github.com/google-gemini/gemini-cli).\n\n**Install as extension:**\n\n```bash\ngemini extensions install https://github.com/w3mg/resultkit-skills\n```\n\n**Or install skills manually:**\n\n```bash\ngit clone https://github.com/w3mg/resultkit-skills.git\nmkdir -p ~/.gemini/skills\ncp -r resultkit-skills/skills/* ~/.gemini/skills/\n```\n\n**Update to latest:**\n\n```bash\ncd resultkit-skills && git pull\ncp -r skills/* ~/.gemini/skills/\n```\n\nThen run the setup skill to configure your API token and default team.\n\n---\n\n## Quick Start\n\n| Action | Claude Code | Codex CLI | Gemini CLI |\n|--------|-------------|-----------|------------|\n| Configure token + team | `/rkit:setup` | `$rkit:setup` | `rkit:setup` |\n| Show today's day plan | `/rkit:today` | `$rkit:today` | `rkit:today` |\n| Add item to today | `/rkit:today add` | `$rkit:today add` | `rkit:today add` |\n| View your default board | `/rkit:board` | `$rkit:board` | `rkit:board` |\n| View team weekly board | `/rkit:weekly` | `$rkit:weekly` | `rkit:weekly` |\n| Parse meeting notes | `/rkit:braindump` | `$rkit:braindump` | `rkit:braindump` |\n\n## Configuration\n\nAll config lives in `~/.config/resultkit/config.json`:\n\n```json\n{\n  \"api_token\": \"<your-bearer-token>\",\n  \"default_team_id\": 123,\n  \"api_base\": \"https://api.resultmaps.com/api/v2\"\n}\n```\n\nRun the `rkit:setup` skill to create or update this file.\n\n---\n\n## Maintainer Guide\n\n### Repository Structure\n\n```\n.claude-plugin/\n  plugin.json            # Claude Code plugin manifest\n  marketplace.json       # Claude Code marketplace catalog\ngemini-extension.json    # Gemini CLI extension manifest\nskills/\n  setup/                 # /rkit:setup skill\n    SKILL.md\n    scripts/api.sh       # Copy of shared api.sh\n    references/\n  today/                 # /rkit:today skill\n  board/                 # /rkit:board skill\n  weekly/                # /rkit:weekly skill\n  braindump/             # /rkit:braindump skill\nscripts/\n  api.sh                 # Source of truth for the API caller\n  deploy.sh              # Deployment script\n  fetch-openapi.sh       # Fetch latest OpenAPI spec\n  install.sh             # Legacy installer (deprecated)\nspecs/                   # Spec-Kit feature specs (one per skill)\nconstitution.md          # Core principles all skills must follow\napi-reference.md         # V2 API endpoint summary\n```\n\n### How the plugin works\n\nThe plugin name is `rkit` (set in `.claude-plugin/plugin.json`). Claude Code automatically namespaces skills by combining the plugin name with the skill folder name:\n\n- `skills/today/SKILL.md` becomes `/rkit:today`\n- `skills/board/SKILL.md` becomes `/rkit:board`\n\nUsers install via the marketplace defined in `.claude-plugin/marketplace.json`, which points to this GitHub repo as the source.\n\n### Updating api.sh\n\n`scripts/api.sh` is the source of truth. Each skill has its own copy at `skills/*/scripts/api.sh` because plugins must be self-contained (no path traversal outside the plugin root).\n\nAfter editing `scripts/api.sh`, sync it to all skills:\n\n```bash\nfor skill in skills/*/; do\n  cp scripts/api.sh \"$skill/scripts/api.sh\"\n  chmod +x \"$skill/scripts/api.sh\"\ndone\n```\n\n### Releasing a new version\n\n1. Make your changes to skill files, api.sh, etc.\n2. Run `/sync-plugin` to sync shared files and bump the version (or `/sync-plugin 2.0.0` for a specific version).\n3. Bump the `version` in `gemini-extension.json` to match.\n4. Commit and push to `main`.\n5. Claude Code users run `/plugin marketplace update`. Gemini CLI users re-run `gemini extensions install`.\n\n### Adding a new skill\n\n1. Create `skills/<name>/SKILL.md` with the standard frontmatter:\n   ```yaml\n   ---\n   name: rkit:<name>\n   description: What it does.\n   user-invocable: true\n   allowed-tools: Bash, Read, AskUserQuestion\n   ---\n   ```\n2. Add a `scripts/` folder and copy `api.sh` into it.\n3. Add a `references/` folder if the skill needs reference docs.\n4. Add the api.sh path resolver to the Current State section (searches Claude Code plugin cache, Claude Code manual install, Codex CLI, Gemini CLI, and local dev):\n   ```\n   - api.sh: !`(setopt +o nomatch 2>/dev/null; shopt -s nullglob 2>/dev/null; for p in \"$HOME/.claude/plugins/\"*/rkit/skills/<name>/scripts/api.sh \"$HOME/.claude/skills/rkit:<name>/scripts/api.sh\" \"$HOME/.agents/skills/<name>/scripts/api.sh\" \"$HOME/.gemini/skills/<name>/scripts/api.sh\" \"scripts/api.sh\"; do [ -f \"$p\" ] && echo \"$p\" && break; done) || echo \"NOT_FOUND\"`\n   ```\n5. Follow the principles in `constitution.md`.\n6. Bump the version in `plugin.json` and push.\n\n### Testing locally\n\nRun Claude Code with the plugin loaded directly from the repo:\n\n```bash\nclaude --plugin-dir /path/to/resultkit-skills\n```\n\nSkills will be available as `/rkit:setup`, `/rkit:today`, etc. without needing to install from the marketplace.\n\n### Syncing the API reference\n\nUse the project skill `/rkit-sync-api-doc` to compare the live OpenAPI spec against `api-reference.md` and update it. Then copy the updated reference to each skill that includes it:\n\n```bash\nfor skill in setup today board weekly; do\n  cp api-reference.md \"skills/$skill/references/api-reference.md\"\ndone\n```\n\n## License\n\nMIT\n",
  "bytes": 7011,
  "sha": "5e3523a42eb7c7e2a3596f59f92d1bcba1470f03a0100d432e954a30a013c6d8",
  "repo_slug": "resultkit-ai/resultkit-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_resultkit_ai_resultkit_skills_810b24bd/readme"
}