Skip to content
Skills Library
Management & product · Analysis

sync-tasks

/sync-tasks

Compare active kotgent tasks with repository guidance, plans, code, tests, TODOs, and Git history, and report task/repository drift with evidence and proposed CLI commands. Use when the user asks to sync, reconcile, map, or compare the kotgent backlog with the current repository. This workflow is always read-only.

Author
Heapy ↗
Repository
kortex ↗
Licence
Apache-2.0
Last repository change
22.10.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 22.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Compare active kotgent tasks with repository guidance, plans, code, tests, TODOs, and Git history, and report task/repository drift with evidence and proposed CLI commands. Use when the user asks to sync, reconcile, map, or compare the kotgent backlog with the current repository. This workflow is always read-only.

Original author description

Compare active kotgent tasks with repository guidance, plans, code, tests, TODOs, and Git history, and report task/repository drift with evidence and proposed CLI commands. Use when the user asks to sync, reconcile, map, or compare the kotgent backlog with the current repository. This workflow is always read-only.

How it works

  1. Stay read-only
  2. Establish the project and task snapshot
  3. Inspect repository evidence in this order
  4. Classify the mapping
  5. Report without applying
Original SKILL.md headings · 75 lines, 703 words
SKILL.md preview
---
name: sync-tasks
description: Compare active kotgent tasks with repository guidance, plans, code, tests, TODOs, and Git history, and report task/repository drift with evidence and proposed CLI commands. Use when the user asks to sync, reconcile, map, or compare the kotgent backlog with the current repository. This workflow is always read-only.
disable-model-invocation: true
---

# Sync Tasks

Build an evidence-backed reconciliation report. Use the `kotgent` CLI for tracker reads and `git` plus
ordinary file inspection for repository evidence. Do not use an MCP server, SDK, direct daemon request,
or helper script.

## Stay read-only

Do not run `task add`, `task claim`, `task comment`, `task review`, `task done`, `task unlink`, `task move`,
`task dep`, `task delete`, `project init`, `project delete`, or `project restore`. Do not edit repository
files. Suggested commands belong only in the report.

Treat successful `task` and `project` stdout as JSON and failure stderr as JSON. Exit `2` means this skill
built an invalid command and stderr may be plain usage text; stop and report it exactly. Never retry a
deleted-project error or restore/reinitialize a project.

## Establish the project and task snapshot

1. Require `git` and `kotgent`, resolve `git rev-parse --show-toplevel`, and read the root
   `.kotgent.json`. Stop if the file is missing or its `id` is not a UUID.
2. Read both `kotgent project list` and, only if needed, `kotgent project list --archived`. Record whether
   the exact UUID is live or archived. An unknown UUID is an error. An archived project may still be read,
   but label it and do not propose an automatic restore.
3. Run `kotgent task list --project <project-uuid>`. Select only rows whose state is exactly `todo` or
   `in_progress`.
4. Run `kotgent task show <ref>` for every selected row. Use the full detail, including body,
   dependencies, linked sessions, and activity; do not reconcile from list titles alone.
5. Record HEAD, branch or detached state, and `git status --short` so the report identifies its snapshot.

## Inspect repository evidence in this order

1. Read applicable `AGENTS.md` and `CLAUDE.md` files first. Treat them as constraints, not backlog items.
2. Find active plan and backlog files. Exclude completed, superseded, archived, or historical plans unless
   they explain a mismatch.
3. Inspect the implementation and tests named by tasks or plans. Use exact symbols, paths, assertions,
   and observable behavior as evidence.
4. Search tracked content for relevant `TODO` and `FIXME` markers. Do not promote every marker into a
   task; require a concrete match to intended repository work.
5. Inspect relevant Git history with focused `git log`, `git show`, or `git blame`. Use commit IDs when
   history proves completion, replacement, or architectural change.
6. Include relevant uncommitted and untracked work from `git status`; never treat a clean HEAD as the
   whole repository when the worktree contains evidence.

Match by scope, acceptance behavior, identifiers, and changed paths. Title similarity alone is not proof.

## Classify the mapping

Assign every tracker task and every concrete repository-only work item exactly one primary label:

- `aligned`: task scope and current repository intent agree.
- `drifted`: both exist, but scope, assumptions, dependencies, or acceptance evidence disagree.
- `missing in repo`: a kotgent task has no current repository evidence.
- `missing in kotgent`: current repository intent has no matching active kotgent task.
- `duplicate`: two or more active kotgent tasks represent the same work; name the canonical ref.

For each row, cite evidence as `path:line`, symbol/test name, task activity entry, worktree path, or commit
ID. State uncertainty instead of upgrading a weak textual similarity into a fact.

## Report without applying

Report the project UUID/status and Git snapshot, then the mapping grouped by label. Include task ref,
state, concise scope, repository counterpart, evidence, and consequence. List repository-only items too.

For every proposed tracker change, print the exact supported `kotgent` command with concrete refs,
project UUID, body, and dependency direction. There is no CLI command to rewrite an existing title or
body; for `drifted`, propose a replacement add and a separately confirmed delete instead of inventing an
update command. Mutations require either a proven current kotgent pane or a supplied session ID. Never
probe IDs found in task `sessions`, read `KOTGENT_SESSION_ID` as identity, or infer the current session
from names, cwd, other environment values, or recency. If needed, use at most one ref-less
`kotgent task show` to prove current-pane resolution: accept
only success or the exact free-session error; this permits the implicit current-pane command form but
does not reveal an ID. If neither form is available, say `session ID required` rather than guessing or
printing a misleading runnable command. Do not execute any proposed command.
Files in this package (2)
  • SKILL.md 5 KB
  • agents/openai.yaml 1 KB

Versions

The database has no other skills named sync-tasks.

Database snapshot: 13.11.2026 · package version 07ddcf4aec74 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100create-tasks
    Create focused kotgent backlog tasks from a user request, specification, issue list, or implementation plan, with repository and session provenance. Use when the user asks to create, add, file, split, or seed tasks in kotgent; do not use for comparing or reviewing an existing backlog.
  • 90review-tasks
    Audit todo kotgent tasks against the current repository and recommend whether to keep, rewrite, merge, drop, or escalate them. Use when the user asks to review, groom, clean up, triage, or validate the todo backlog for completed, obsolete, conflicting, duplicate, absorbed, or…
  • 100file-todos
    This skill should be used when managing the file-based todo tracking system in the todos/ directory. It provides workflows for creating todos, managing status and dependencies, conducting triage, and integrating with slash commands and code review processes.
  • 90sync-project
    Reconcile a workspace project's config with its backend (Linear/hub) project. Use when the user invokes /dev-loop:sync-project, or asks to "sync the project", "reconcile with Linear", "the project was renamed/archived in Linear", or "check config vs backend drift". Read-only by…
  • 96sync-roadmap
    Reconcile ROADMAP.md checkbox state against on-disk SUMMARY.md presence. Default: silently corrects drift; --dry-run previews; --interactive prompts per change. Triggers on: "sync roadmap", "reconcile roadmap", "fix roadmap drift", "is the roadmap accurate".
  • 86release-notes
    Compare the repository with the team's Folio wiki and write release notes: read git log since the last tag, read the Roadmap table, create or update a Release notes page and add what the roadmap table is missing. Use when asked for release notes or to sync the wiki with the code.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.