← KapaCONTENT HISTORY

Update to Kapa

Snapshot Oct 7, 2026 · 18:03 UTC · version 0.1.0

Collection source: downloaded plugin package.

WHAT CHANGED · RULE-BASED ANALYSIS

First saved snapshot

No earlier snapshot is available to establish a change.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "description": "Set up a Kapa GitHub pull requests source so repository pull requests are ingested. Use when the user wants Kapa to answer from changes and review discussion in GitHub PRs.",
  "included_files": [],
  "name": "kapa-setup-github-pull-requests",
  "skill_md_contents": "---\nname: kapa-setup-github-pull-requests\ndescription: Set up a Kapa GitHub pull requests source so repository pull requests are ingested. Use when the user wants Kapa to answer from changes and review discussion in GitHub PRs.\n---\n\n# Set up GitHub pull requests\n\nPull request discussion is largely about implementation rather than usage, so\nsay that when offering it: it suits a team that wants change history, and\nsuits a user-facing assistant less well.\n\n## 1. Create the source\n\n`create_github_pull_requests_source` with `project` and `name`. Keep the id.\n\n## 2. Configure it\n\n`set_github_pull_requests_config` with `source_github_pull_requests`,\n`repo_owner` and `repo_name`.\n\n`repo_owner` and `repo_name` together make the repository path. For\n`github.com/acme/docs`, the owner is `acme` and the name is `docs`.\n\n`personal_access_token` is **required only for a private repository**. Do not\nask for one for a public repo. If you do need it, it is the user's secret: ask,\nnever invent one, and tell them it needs the `repo` scope.\n\n## Check the repository first\n\n`validate_github_pull_requests_repo` with `repo_owner`, `repo_name` and, for a private repo,\n`personal_access_token`. It answers HTTP 200 with `false` when the repo cannot\nbe reached, so read the body rather than the status.\n\nA false covers all of: the repo does not exist, it is private and the token is\nmissing, or the token lacks the `repo` scope. Offer those to the user rather\nthan guessing which.\n\n`list_github_pull_requests_labels` then shows the repository's labels.\n\n## Let the user choose the filters\n\nShow these options and ask. Do not pick for them and do not apply a default\nsilently.\n\n- `pr_state`: which states to read. Merged pull requests describe changes that\n  shipped, ones closed without merging describe changes that did not, and open\n  ones are still in flight.\n- `pr_age`: how far back to read, or all history.\n- `labels`: restrict to specific labels, or leave out for all.\n\nSay what each does, then set what they asked for.\n\n## Finish the job\n\nSaving the configuration starts ingestion. There is no separate publish step.\n\nThen call `list_sources` with `project_id` to confirm what the project holds.\n\n## Shared Kapa workflow rules\n\nTools act as the connected user with that user's project permissions. Resolve the intended project and use only authorized data. Do not invent credentials, source IDs, filters, or tool results. Check the available tool schema before passing arguments.\n\nExplain and obtain approval for ingestion and its quota cost before saving a configuration that starts ingestion or calling `start_crawl`; existing explicit approval for that exact action is sufficient. Ask the user to choose source scope and filters. Validate credentials and discover accessible content before saving. Keep credentials out of visible results, logs, and exported artifacts. Use a secure credential input if the host provides one.\n\nFor a web source, preview the exact configuration and inspect the extracted article content before ingestion. Report queued, running, failed, and completed states accurately. If uncertain about Kapa behavior, use `search_kapa_docs` when available.\n"
}

SHA-256 of public snapshot: fb9399de64386563918159f92dc1dbf54744e818cd12982a0794b9f4cfe62d9e