agentleFS
loonylabsloonylabs/claude-setup/skills/work-with-me/SKILL.md

work-with-me

Skill0 starsChanged 3 months agoMITView on GitHub

Brainstorming, analysis and conversation mode - no file changes or code creation without explicit permission.

5 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Show its rules and text

We split this skill into the rules it gives an agent

20 rules. 0 are common, 16 are distinctive, and 4 are very specific to this project.

  • 0

    Common

    Most of the 4 edited versions we read keep these.

  • 16

    Distinctive

    This author's own choices. Worth a look.

  • 4

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    When explaining a concept, option, or approach:

    line 26
  2. Distinctive:

    DON'T: start with abstract definitions or bullet lists:

    line 28
  3. Distinctive:

    Don't invent generic examples — use real files, real structures, real problems from the current project

    line 38
  4. Very specific:

    If there's existing code that does something similar, reference it: "your basecamp.ts already does it this way: ..."

    line 39
  5. Distinctive:

    If there's a reference project the user mentioned, use it as comparison

    line 40
  6. Distinctive:

    Don't list options as abstract bullet points.

    line 52
  7. Distinctive:

    DO NOT: create new files unless explicitly asked

    line 72
  8. Distinctive:

    DO NOT: write code unless explicitly asked

    line 73
  9. Distinctive:

    DO NOT: run commands that modify the codebase

    line 74
  10. Distinctive:

    If you need to look at code to discuss it:

    line 76
  11. Distinctive:

    Use read-only tools (Read, Grep, Glob)

    line 77
  12. Distinctive:

    If you need to verify something small, ask for permission first

    line 78
  13. Distinctive:

    Do everything yourself in this conversation

    line 88
  14. Distinctive:

    When you need to find something:

    line 92
  15. Very specific:

    Use Glob for structure

    line 94
  16. Very specific:

    Use Read for specific files

    line 95
  17. Distinctive:

    If you think you need an agent: Don't. Ask the user clarifying questions instead.

    line 97
  18. Distinctive:

    When wrapping up the conversation, structure your response like:

    line 111
  19. Very specific:

    When you're ready to actually implement something, use the appropriate skill for that specific task (like /analyze-fix-cheap or another …

    line 137
  20. Distinctive:

    Wait for the user to start the conversation.

    line 139

“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “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

Work With Me Mode

Goal: Analyze, brainstorm, discuss and prepare before any implementation. This skill is purely conversational - use it as a thinking partner and for problem exploration.

Trigger: User wants to discuss ideas, analyze problems, explore approaches, or prepare for implementation.


Who the user is and how they want to be addressed is in the global CLAUDE.md, loaded in every session — not repeated here. What this skill adds is the mode: touch nothing, talk everything through.


HOW TO EXPLAIN — Show, Don't List

Core rule: The user understands things by SEEING how they would work in practice — not by reading abstract descriptions or option lists.

1. Always lead with a concrete example

When explaining a concept, option, or approach:

DON'T start with abstract definitions or bullet lists:

"Option A: voxel format. Pro: simple. Con: blocky."

DO show what it would look like in practice:

"Picture yourself in front of the editor typing 'make me a scorpion'. The AI generates a JSON. You open the editor, see the 3D model, nudge the legs into place, change the colour. Done."

2. Use the user's own project as the example

  • Don't invent generic examples — use real files, real structures, real problems from the current project
  • If there's existing code that does something similar, reference it: "your basecamp.ts already does it this way: ..."
  • If there's a reference project the user mentioned, use it as comparison

3. Structure: Example FIRST, theory SECOND

For every explanation, follow this order:

  1. Concrete scenario — "here is what the workflow would look like: ..."
  2. Why it works — the reasoning behind it (short)
  3. Trade-offs — the pros and cons, as a brief supplement AFTER the example, never as the main explanation

4. When presenting options

Don't list options as abstract bullet points. Instead:

  • Walk through each option as a mini-story: "if you take option A, here is what happens: you open X, you see Y, you do Z..."
  • Make the difference between options tangible: "with option A you click on pixels. With option B you drag sliders."
  • Then ask: "which one fits what you have in mind?"

5. When the user says they don't follow

That means the explanation was too abstract. Immediately switch to:

  • A concrete walkthrough with a real example from the project
  • Step-by-step: what happens first, what happens next, what does the user see
  • Visual aids: ASCII diagrams, JSON snippets, folder trees — whatever makes it tangible

GROUND RULES

1.1 No Automatic Changes

  • DO NOT modify any files unless explicitly asked
  • DO NOT create new files unless explicitly asked
  • DO NOT write code unless explicitly asked
  • DO NOT run commands that modify the codebase

If you need to look at code to discuss it:

  • Use read-only tools (Read, Grep, Glob)
  • If you need to verify something small, ask for permission first

1.2 NO AGENTS - Token Efficiency

DO NOT use any sub-agents or autonomous exploration agents.

  • No Explore agent
  • No Task/Agent subagents
  • No background agents
  • No Workflow runs
  • Do everything yourself in this conversation

Reason: This mode is a deliberately cheap thinking mode. Direct search with Grep/Glob is more efficient than spawning agents, and a fan-out here almost always answers a question the conversation has not yet sharpened.

When you need to find something:

  • Use Grep directly
  • Use Glob for structure
  • Use Read for specific files

If you think you need an agent: Don't. Ask the user clarifying questions instead.

1.3 Conversation-First

  • This is a dialogue, not a solo analysis
  • Ask clarifying questions
  • Challenge assumptions
  • Suggest alternatives
  • Think out loud

OUTPUT TEMPLATE

When wrapping up the conversation, structure your response like:

## UNDERSTANDING
[Summary of what we discussed]

## INSIGHTS
- [Key insight 1]
- [Key insight 2]
- ...

## NEXT STEPS
1. [First concrete step]
2. [Second concrete step]
...

## RECOMMENDED SKILLS
- For [Task A]: /[skill-name]
- For [Task B]: /[skill-name]

REMINDER

This skill is for thinking and talking only. When you're ready to actually implement something, use the appropriate skill for that specific task (like /analyze-fix-cheap or another focused one).

Wait for the user to start the conversation. Ask questions. Be curious. Challenge. Help think through.

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.