Refine README content to reflect recent changes

Updated README to reflect recent changes to the skill and its environment.
This commit is contained in:
Eoghan Henn
2026-04-28 16:23:53 +02:00
committed by GitHub
parent fb75b65f7c
commit 66018064db

View File

@@ -1,8 +1,10 @@
# One Skill to Rule Them All
_UPDATE AFTER THREE MONTHS OF USING THIS: The meta-skill has **logged and applied over 600 improvements across my 40 skills**, all of which were themselves created based on observations by the meta-skill._
**The meta-skill that builds and improves all your skills, including itself.**
Creating skills is powerful but time-consuming. And the skills that do get built stay frozen they never learn from how you actually use them.
Creating skills is powerful but time-consuming. And the skills that do get built stay frozen: they never learn from how you actually use them.
Task Observer fixes both problems. It's a skill that runs alongside your work, watches what you do, and does two things:
@@ -23,51 +25,48 @@ At the end of each session, it produces a structured observation log: what it no
## Who it's for
You don't need to be a developer. If you use skills in any capacity for writing, research, client work, analysis, content creation, anything and you want those skills to get better over time instead of staying frozen, this is for you.
You don't need to be a developer. If you use skills in any capacity (for writing, research, client work, analysis, content creation, anything) and you want those skills to get better over time instead of staying frozen, this is for you.
It's particularly valuable if you've built multiple skills and want a systematic way to maintain and improve them without manually auditing each one. But it's equally useful if you have zero skills the observer will start identifying and drafting them for you.
It's particularly valuable if you've built multiple skills and want a systematic way to maintain and improve them without manually auditing each one. But it's equally useful if you don't have any skills yet: the observer will start identifying and drafting them for you.
## How it works
No configuration required to get started. Drop the SKILL.md into your skills directory and it activates automatically during task-oriented sessions. It reads the available skills in your environment, watches how they perform during your work, and logs observations using a structured format.
**The best way to get started with this work setup in any environment is probably to grab the skill, readme and user guide, feed them to your AI and let it guide you towards the best setup for your particular environment** - No matter which AI system you use. As long as skills are supported, you should be able to use this approach with some adjustments.
The observer doesn't modify your skills directly. It produces recommendations that you review. You stay in control of what changes and when.
**In Claude Cowork:** Full experience. The observer writes observation logs to your filesystem, so improvements persist between sessions and can be actioned immediately.
**In Claude Cowork (including Dispatch) or Claude Code in the desktop app:** Full experience. The observer writes observation logs to your filesystem, so improvements persist between sessions and can be actioned easily.
**In Claude.ai web/mobile:** Handoff doc mode. Since there's no filesystem access, the observer produces a structured handoff document at the end of your session that you can use to update your skills manually.
**In Claude.ai web or or Claude Chat in the desktop app / mobile app:** Handoff doc mode. Since there's no filesystem access, the observer produces a structured handoff document at the end of your session that you can use to update your skills manually.
## Compatibility
The best way to get started with this work setup in any environment is probably to grab the skill, readme and user guide, feed them to your AI and let it guide you towards the best setup for your particular environment - No matter which AI system you use. As long as skills are supported, you should be able to use this approach with some adjustments.
**Tested and designed for:**
- Claude Cowork (full experience with filesystem access)
- Claude Dispatch
- Claude.ai web interface (handoff doc mode)
- Claude mobile app (handoff doc mode)
- Claude Code in the desktop app
**Expected to work but untested:**
- Claude Code — the methodology and format should translate directly, but I haven't verified it in practice
- Claude Code without desktop app — the methodology and format should translate directly, but I haven't verified it in practice
**Potentially compatible with caveats:**
- Other Agent Skills-compatible platforms (ChatGPT, Codex CLI, Gemini CLI, Cursor, etc.) — the skill uses Claude-centric concepts like `<available_skills>` and skill-creator references that other systems would need to interpret or adapt. The SKILL.md format is cross-platform, but the content assumes Claude's architecture.
If you try it on another platform, please open an issue and tell me.
If you try it on another platform, please let me know how it goes. Issues and pull requests welcome.
## Quick start
1. Download `SKILL.md` from this repository
2. Add it to your skills:
- **Cowork / Claude.ai:** Upload as a custom skill via Settings → Capabilities → Skills
- **Claude Code:** Place in your skills directory (e.g., `~/.claude/skills/task-observer/SKILL.md`)
- **Via the skills CLI:** `npx skills add rebelytics/one-skill-to-rule-them-all`
3. Read the user guide at [https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/USER-GUIDE.md](https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/USER-GUIDE.md)
4. Work normally. The observer activates automatically during task-oriented sessions
5. Review the observation log at the end of your session
6. Apply the improvements you agree with to your other skills
1. I recommend that you give the content of this repo (skill, readme and user guide) to the AI system of your choice and let it guide you towards the ideal configuration for your individual setup.
2. Read the user guide at [https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/USER-GUIDE.md](https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/USER-GUIDE.md)
3. Make sure that the skill loads in all sessions where it's needed (I solved this via an instruction in my CLAUDE.md file)
4. Try to remember to ask "Any observations logged" when you finish a session (I do this every time I archive a session). Often, the skill then finds additional improvement potential that it didn't log before.
5. Schedule a recurring review session that applies all open obervations. Mine runs Monday, Wednesday and Friday morning, but you should adapt this to your needs.
## The self-improving part
This is the detail that makes the task observer different from a linter or a review checklist. Because it runs during every session and observes all active skills — including itself — it captures improvements to its own methodology over time.
This is the detail that makes the task observer truly beautiful in my opinion. Because it runs during every session and observes all active skills — including itself — it captures improvements to its own methodology over time.
If it misses something, or if its observation format could be clearer, or if it's triggering in contexts where it shouldn't — it notices, and it logs that too. The skill that improves all your skills also improves itself.
@@ -77,7 +76,7 @@ This is an early release. If you use it, I want to hear from you:
- **Bug reports and feature requests:** Open an issue
- **Observations about the observer:** If the skill captures something interesting about its own behaviour, I'd love to see it
- **Platform compatibility reports:** Tried it somewhere other than Cowork or Claude.ai? Tell me what happened
- **Platform compatibility reports:** Tried it somewhere other than Claude? Tell me what happened
## License