Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Remote Workspace Fit for Copilot and Claude Code

A free, read-only agent skill that audits repository evidence before recommending one of three remote-development paths:

  • use a rebuildable remote-agent task;
  • use a persistent development workspace when live processes or interactive state justify it; or
  • gather more evidence before choosing infrastructure.

The skill has no scripts, hooks, MCP servers, telemetry, network calls, or required service integration. Review the SKILL.md source before installing it.

Install with any Agent Skills client

The open Agent Skills installer discovers workspace-fit directly from this repository and can install it for Codex, Cursor, Claude Code, GitHub Copilot, and other compatible clients:

npx skills add Anchras/terminalbox-tools --skill workspace-fit

Choose the client and project or global scope in the installer. The source copied by this command is the same read-only SKILL.md reviewed above.

Review the indexed skill, install count, and security scans on skills.sh.

Install with GitHub Copilot CLI

copilot plugin install Anchras/terminalbox-tools:plugins/remote-workspace-fit

Start Copilot in a repository and ask it to use the workspace-fit skill for a read-only audit.

Install with Claude Code

claude plugin marketplace add Anchras/terminalbox-tools
claude plugin install remote-workspace-fit@terminalbox-tools

Then run this inside a repository:

/remote-workspace-fit:workspace-fit

The client copies the plugin into its local plugin cache. The audit reads only the repository evidence allowed by the skill. Repository context stays within GitHub Copilot or Claude Code under the user's existing provider settings and is not sent to the plugin author.

What the audit uses

The skill checks tracked orientation docs, manifests, lockfiles, development scripts, container configuration, and CI workflows. It looks for two different kinds of evidence:

  • whether a clean clone has enough instructions to reconstruct the useful environment; and
  • whether useful state lives outside Git as a running process, local service or data set, interactive shell, or continuously steered session.

It returns one recommendation, three to six file-backed observations, the rebuild plan, persistence triggers, decision-relevant unknowns, and one safe next test.

Illustrative result

Recommendation: Persistent workspace — the documented workflow depends on a live local database
and a continuously running worker that a fresh repository task would need to recreate.

Repository evidence:
- compose.yaml defines the development database and queue
- scripts/dev starts the web process and background worker together
- CLAUDE.md documents cross-device handoff to the same tmux session

Rebuild plan:
- clone the repository, restore locked dependencies, and start the documented service stack

Persistence triggers:
- database contents, worker state, and the interactive tmux session

Unknowns:
- whether the database can be replaced with disposable fixtures for this task

Next test:
- confirm a fresh environment can complete one representative task without the existing services

This example is an output shape, not a claim about a particular repository. The recommendation must follow the evidence found in the repository being audited.

Provider independence

The skill recommends the existing remote-agent workflow when a clean clone can reconstruct the useful state. When repository evidence supports persistent live state, it describes the required capabilities without naming a vendor. It makes no purchase recommendation when the evidence is incomplete. The audit does not require Terminalbox or any service supplied by the plugin author.

License

MIT. See LICENSE.