kamranahmedse/diffity
6 skills3.7k installs4.1k starsGitHub
Install
npx skills add https://github.com/kamranahmedse/diffitySkills in this repo
1Diffity Diffdiffity-diff is a thin orchestration skill for Kamran Ahmed’s diffity CLI: the agent verifies the binary, runs diffity with an optional ref (main..feature, HEAD~3, or a GitHub pull URL), backgrounds the process correctly, waits two seconds, reads diffity list --json for the port, and tells the user the localhost URL without leaking session internals. Default behavior covers unstaged working tree changes when no ref is passed. It targets solo builders who want a browser-native diff experience instead of paging through git diff in the terminal, especially before human or AI review. The README explicitly chains forward: leave comments in the browser then invoke diffity-resolve, or run diffity-review for an automated pass. Treat it as the entry step in a three-skill review mini-pipeline rather than a standalone linter. Complexity is beginner-friendly assuming Node/npm is available.718installs2Diffity ReviewDiffity Review teaches an agent to inspect a code change and leave structured feedback using the diffity CLI rather than dumping a generic chat review. Solo builders shipping from feature branches install it when they want file- and line-anchored comments that behave like a lightweight review tool integrated with git refs. You can scope to the working tree or an explicit range, and narrow the pass to security, performance, naming, error handling, types, or logic when you already know the risk surface. The workflow starts by verifying diffity is installed globally, then aligning the review session with the correct ref, pulling the diff context, and emitting comments with required file, line, and body fields plus optional end-line and side for old versus new code. General comments cover cross-cutting issues without a line anchor, and resolve or dismiss flows support closing threads. It pairs naturally with pre-merge Ship habits—especially for indie teams without a full PR bot stack—while still expecting you to read findings before merging.695installs3Diffity ResolveDiffity-resolve is an agent skill for solo builders who already run Diffity review sessions and want the coding agent to act on open comments instead of copying feedback by hand. It encodes the diffity CLI contract: list threads as JSON, anchor comments with --file, --line, optional --end-line and --side, reply, resolve with summaries, or dismiss with reasons. The workflow starts by verifying diffity is on PATH (npm install -g diffity if not) and that an active session exists—otherwise the user must start diffity or invoke the diff skill first. Instructions walk the agent from fetching open items through implementing fixes and marking threads resolved, with an optional thread-id to scope work to one discussion. Pair it with your normal Ship review pass when feedback lives in Diffity rather than GitHub-only comments; it is not a substitute for starting the review or running tests after fixes.693installs4Diffity TreeDiffity Tree is an agent skill that starts the diffity file-tree browser for the repository you are working in. Solo and indie builders use it when they want a visual map of the codebase and a lightweight review surface in the browser instead of scrolling raw diffs in chat. The skill checks that the diffity CLI is on PATH, installs it globally via npm if needed, and runs `diffity tree` with background execution so the agent does not block on the dev server. It then reads the active port from `diffity list --json` and gives you a short message with the URL. The intended rhythm is browse and comment in the browser, then invoke the resolve-tree skill to turn notes into fixes. It fits teams of one shipping with Claude Code, Cursor, or Codex where shell and browser access are available.547installs5Diffity Resolve Treediffity-resolve-tree teaches your coding agent to work through open review comments collected in the Diffity tree browser. After verifying the Diffity CLI is installed and a review session is active, the agent fetches open threads as JSON—including file paths, line numbers, and full comment bodies—then implements the requested changes in the repository and closes each thread with resolve or dismiss actions. You can scope work to one thread via an optional thread-id argument, which helps large reviews stay incremental. Reply and comment subcommands support two-way review dialogue when a fix needs clarification. The workflow fits solo builders who use Diffity as a structured alternative to ad-hoc PR comment threads and want the agent to execute fixes rather than manually hopping between browser and editor. It assumes npm-global or otherwise available diffity and an started tree session, not a greenfield project with no review context.542installs6Diffity TourDiffity Tour is an agent skill for creating guided code tours that open in the browser with a sidebar story and highlighted source lines. Solo builders and small teams use it when a plain repo grep is not enough—you want a narrated path through authentication, request lifecycle, storage, or a language concept like closures or React hooks. The skill documents a fixed CLI contract: start a tour with a topic, append steps that pin file paths and line ranges with human-readable bodies, then finalize so the tour can be opened interactively. When you pass a GitHub pull request URL, the tour shifts into Review mode where the PR diff scopes the walkthrough and the wrap-up must include a PR-flags list, which makes it useful right before merge. It is procedural knowledge for agents that already have the Diffity CLI in the environment, not a hosted documentation product by itself.541installs