Agent skill

Using Long Task

by suriyel in suriyel/longtaskforagent

A skill your agent uses when starting any session in a long-task project - routes to the correct phase skill based on project state

No licenceAuto-check passed

Install Using Long Task

skills CLI
$ npx skills add suriyel/longtaskforagent --skill using-long-task -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install suriyel/longtaskforagent using-long-task --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/suriyel/longtaskforagent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/using-long-task .claude/skills/using-long-task && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
using-long-task
GitHub stars
177
Token cost
~3.6k tokens
SKILL.md length
1,195 words
Files
3 (incl. references)
Skills in repo
17
Repo updated
First seen
Licence
None found

At a glance

A skill your agent uses when starting any session in a long-task project - routes to the correct phase skill based on project state

  • Works in 8 steps: Check bugfix-request.json in project… → Check increment-request.json in project… → Check feature-list.json in project root… → …
  • Starting any session in a long-task project - routes to the correct phase skill based on project state
  • SKILL.md covers How to Access Skills, Phase Detection, Skill Catalog and Key Files (shared contract), plus 3 more sections
  • Calls python and git

What it does

Using Long Task is an agent skill from suriyel/longtaskforagent. Use when starting any session in a long-task project - routes to the correct phase skill based on project state

Its SKILL.md is about 3.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/architecture.md` and `references/roadmap.md`).

When your agent uses it

  • Starting any session in a long-task project - routes to the correct phase skill based on project state

Example prompts

  • “/using-long-task”

Requirements

  • Python 3

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Check bugfix-request.json in project root → if exists → long-task-hotfix (HIGHEST priority)
  2. Check increment-request.json in project root → if exists → long-task-increment
  3. Check feature-list.json in project root → if exists
  4. Check docs/plans/*-ats.md → if any match → long-task-init (ATS done, proceed to init)
  5. Check docs/plans/*-design.md → if any match → long-task-ats (Design done, proceed to ATS)
  6. Check docs/plans/*-ucd.md → if any match → long-task-design (UCD done, proceed to design)
  7. Check docs/plans/*-srs.md → if any match → long-task-ucd (SRS done, UCD next; if no UI features the UCD skill auto-skips to design)
  8. Otherwise → check codebase conventions

What it can do on your machine

Read from SKILL.md and the folder at commit ca67fe1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Using Long Task loads about 3.6k tokens when it runs, and up to ~13k if it reads all its reference files. Until then it costs about 32 tokens; SKILL.md has 1,195 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~32
When it runs · the whole SKILL.md, loaded when a task matches
~3.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~13k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 1,195 words (~3,624 tokens).

“You are in a long-task multi-session project. You MUST invoke the correct phase skill BEFORE any response or action — including clarifying questions.”

— opening of SKILL.md by suriyel
name
using-long-task

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files (references) in skills/using-long-task of suriyel/longtaskforagent.

  • SKILL.md
  • references/architecture.md
  • references/roadmap.md

Open the folder on GitHubat commit ca67fe1

Compare with similar skills

Using Long Task next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Using Long Task compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Using Long Task this skillsuriyel/longtaskforagent177—~3.6kAutomated safety check: PassNone
StartDonchitos/Claude-Code-Game-Studios26k—~6.4kAutomated safety check: PassMIT
OmniRoute Routing CLIdiegosouzapw/OmniRoute74k1 repos~342Automated safety check: PassMIT
OmniRoute Combo Routingdiegosouzapw/OmniRoute74k—~2.1kAutomated safety check: PassMIT
Intelligence Routeruvnet/ruflo74k—~874Automated safety check: NotesMIT
SPA Routes and Featureslobehub/lobehub83k—~3.2kAutomated safety check: PassCustom licence

Similar skills

  • Start

    Donchitos/Claude-Code-Game-Studios

    First-time onboarding — asks where you are, then guides you to the right workflow.

    26k GitHub stars~6.4k tokensUpdated 8 days ago
    Game DevelopmentAuto-check passed
  • OmniRoute Routing CLI

    diegosouzapw/OmniRoute

    Creates, switches, and inspects OmniRoute model-routing combos, plus a suggestion command with cost and latency constraints.

    74k GitHub starsUsed in 1 repo~342 tokens
    AI & LLM EngineeringAuto-check passed
  • OmniRoute Combo Routing

    diegosouzapw/OmniRoute

    Manages OmniRoute routing combos through its REST API: create and update combos, choose from 19 strategies, set fallback chains, test outcomes and read metrics.

    74k GitHub stars~2.1k tokensUpdated today
    Backend & APIsAuto-check passed
  • Intelligence Route

    ruvnet/ruflo

    Route tasks via the 3-tier model selector and learned patterns; emits a routing rationale via hooksexplain

    74k GitHub stars~874 tokensUpdated today
    DevelopmentAuto-check: notes
  • Explains LobeHub's split between src/routes page segments and src/features domain code, and where router config, redirects and platform adapters belong.

    83k GitHub stars~3.2k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Routing

    alsk1992/CloddsBot

    Multi-agent routing, channel bindings, and tool policies. An agent skill from alsk1992/CloddsBot.

    2.9k GitHub stars~1.6k tokensUpdated 5 days ago
    Agent WorkflowsAuto-check passed

More from suriyel/longtaskforagent

All 17 skills in this repo
  • Long Task Init

    suriyel/longtaskforagent

    A skill your agent uses when ATS doc exists (or auto-skipped) but feature-list.json not yet created - scaffold project artifacts and populate features from Design §10.2

    177 GitHub stars~5.6k tokensUpdated 3 mo ago
    Auto-check: notes
  • Long Task Explore

    suriyel/longtaskforagent

    A skill your agent uses for on-demand deep exploration of an existing codebase - analyzes architecture, data flow, domain model, API surface, dependencies, and code health

    177 GitHub stars~2.7k tokensUpdated 3 mo ago
    Auto-check passed
  • Long Task TDD

    suriyel/longtaskforagent

    A skill your agent uses when implementing a feature through TDD in a long-task project - enforces Red-Green-Refactor cycle

    177 GitHub stars~4.4k tokensUpdated 3 mo ago
    Auto-check: notes
  • Long Task Ats

    suriyel/longtaskforagent

    A skill your agent uses when design doc exists but no ATS doc and no feature-list.json - generate a global Acceptance Test Strategy mapping every requirement to acceptance scenarios with category…

    177 GitHub stars~3.7k tokensUpdated 3 mo ago
    Auto-check passed
  • Long Task Design

    suriyel/longtaskforagent

    A skill your agent uses when SRS doc exists but no design doc and no feature-list.json - take the approved SRS as input and produce an architecture/design document focused on HOW to build it

    177 GitHub stars~4.5k tokensUpdated 3 mo ago
    Auto-check passed
  • Long Task Hotfix

    suriyel/longtaskforagent

    A skill your agent uses when bugfix-request.json exists - validate, reproduce, root-cause, and enqueue a user-reported bug as a category=bugfix feature, then chain to Worker for TDD fix

    177 GitHub stars~2.2k tokensUpdated 3 mo ago
    Auto-check passed

Questions about Using Long Task

What does Using Long Task do?

A skill your agent uses when starting any session in a long-task project - routes to the correct phase skill based on project state. Using Long Task is an agent skill from suriyel/longtaskforagent.

When should I use Using Long Task?

Using Long Task fits situations like: starting any session in a long-task project - routes to the correct phase skill based on project state.

How do I install Using Long Task in Claude Code?

Run `npx skills add suriyel/longtaskforagent --skill using-long-task -a claude-code`. Or copy the skill folder (skills/using-long-task in suriyel/longtaskforagent) into .claude/skills/using-long-task in your project. Claude Code loads it when a task matches its description.

How do I install Using Long Task in Codex?

Run `npx skills add suriyel/longtaskforagent --skill using-long-task -a codex`. Or copy the skill folder (skills/using-long-task in suriyel/longtaskforagent) into .agents/skills/using-long-task in your project. Codex loads it when a task matches its description.

Can I use Using Long Task in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add suriyel/longtaskforagent --skill using-long-task -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/using-long-task, .gemini/skills/using-long-task, .github/skills/using-long-task and .opencode/skills/using-long-task in your project.

What does Using Long Task need to run?

Going by SKILL.md and its folder, Using Long Task needs the command-line tools its instructions call (python and git). Our summary lists: Python 3.

Does Using Long Task access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Using Long Task safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Using Long Task use?

No licence was found for Using Long Task or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Using Long Task use?

About 3.6k tokens (SKILL.md is roughly 14k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 9.2k tokens, read only when the agent opens those files.

What are the alternatives to Using Long Task?

Skills that share tags, products or a category with Using Long Task: Start (Donchitos/Claude-Code-Game-Studios, 26k stars), OmniRoute Routing CLI (diegosouzapw/OmniRoute, 74k stars), OmniRoute Combo Routing (diegosouzapw/OmniRoute, 74k stars) and Intelligence Route (ruvnet/ruflo, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Using Long Task?

suriyel (a GitHub user) maintains it in suriyel/longtaskforagent, which has 177 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on June 23, 2026.

Source: suriyel/longtaskforagent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.