agentleFS
wayne930242wayne930242/straw-boss/skills/boss-assistant/SKILL.md

boss-assistant

Skill5 starsChanged 54 days agoMITView on GitHub

Use when named by the user or when a main agent reports Straw Boss coordination friction.

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 3 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Keep a report's blocked step pending until its recipient is reachable.

    line 10
  2. Distinctive:

    Read back the repaired state and have the reporting main agent exercise its blocked step and next handoff.

    line 22
  3. Distinctive:

    Read back the published URL and content.

    line 41

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Resolve the recipient

Find or open the assistant through agent-feedback. Route a report to the existing assistant. Keep a report's blocked step pending until its recipient is reachable; independent work can continue.

Repair the coordination relationship

A report states expected versus actual behavior and the blocked step; references carry the task/plan, running version, reproduction, and evidence. Acknowledge its message id and combine reports with the same evidenced root cause.

Identify the owner and the relationship blocking progress: registration, endpoint, dependency, shared resource, checkpoint, or cleanup. Accept each task owner's work conclusions and verify the coordination state needed for the repair. Apply mutations serially through their owners using dispatching-work, contacting-orchestrators, or handoff-orchestrator. User-owned conflicts return to the user while current direction stands.

Read back the repaired state and have the reporting main agent exercise its blocked step and next handoff. Attach the result to the report; distinguish executable tests from the actual UAT outcome. Report on state changes or user questions.

Carry a source finding

Locate a Straw Boss checkout from cwd, the orchestrator directory, or configured apps. Confirm its git root and remote and read local instructions and working-tree state. The installed cache identifies the running version; the confirmed checkout owns source edits.

Straw Boss's own leveraging-tasks route is handoff-orchestrator, which owns design, implementation, and verification: hand the confirmed scope, finding, and reproduction to an orchestrator rooted in that checkout rather than editing plugin source from whichever project session hit the friction, and dispatch the source work from there. Once that dispatch reports done, bump plugin.json's version, push, run bash scripts/install.sh in that checkout, then resume the original work. For performance or storage friction, carry a relevant baseline, affected ownership/recovery contract, and the same workload for comparison. Return the measured result and actual UAT outcome to the reporting agents, including whether the running version contains the repair.

Prepare an issue or PR draft from the confirmed evidence. Resolve upstream from the checkout remote or installed manifest, check accessible existing reports for duplicates, and remove credentials/private task content. With no checkout, retain an issue draft and ask for a location only if needed for a repair. Once reviewable, resolve the user's publication decision; an authorized publication includes its required feature-branch push. Read back the published URL and content.

Complete when: each report is restored or has an owner, blocker, and next event; repair evidence is attached; each proposal has a published result or local draft location. Preserve undelivered replies and report their delivery failure.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.