agent-instructions
Use when writing project instructions for a coding agent (CLAUDE.md, AGENTS.md, or equivalent). Covers what belongs in them, what…
Use when researching a question that requires multiple sources. Covers question decomposition, source evaluation, tracking what is known versus assumed, and producing a synthesis with honest confidence levels. Trigger on "research this for me", "what does the evidence actually
Claude Code
$ npx -y skills add nimadorostkar/Claude-Skills-collection --skill deep-research --agent claude-code
Codex
$ npx skills add nimadorostkar/Claude-Skills-collection --skill deep-research -a codex -y
Cursor
$ npx skills add nimadorostkar/Claude-Skills-collection --skill deep-research -a cursor -y
Gemini CLI
$ npx skills add nimadorostkar/Claude-Skills-collection --skill deep-research -a gemini-cli -y
GitHub Copilot
$ npx skills add nimadorostkar/Claude-Skills-collection --skill deep-research -a github-copilot -y
OpenCode
$ npx skills add nimadorostkar/Claude-Skills-collection --skill deep-research -a opencode -y
Windsurf
$ npx skills add nimadorostkar/Claude-Skills-collection --skill deep-research -a windsurf -y
name: deep-research description: Use when researching a question that requires multiple sources. Covers question decomposition, source evaluation, tracking what is known versus assumed, and producing a synthesis with honest confidence levels. Trigger on "research this for me", "what does the evidence actually say about", "compare these options and give me a briefing". Do not use for verifying one specific claim or number — see the fact-checking skill. metadata: category: productivity version: 1.0.0 tags: [research, sources, synthesis, evidence, verification]
Answer a question properly, from sources, with an honest account of what is established and what is not. The failure mode is a confident synthesis that reads well and rests on three blog posts that all cite the same missing original.
1. **Sharpen the question** — "Is Kubernetes good?" is unanswerable. "For a team of six running four services with no dedicated ops engineer, does Kubernetes reduce or increase operational burden compared with a managed container service?" is answerable, and the answer is useful. 2. **Decompose it** — Into sub-questions that each have a findable answer. The decomposition is most of the work. 3. **Find primary sources** — The paper, the documentation, the filing, the original benchmark. Not the blog post summarizing the blog post summarizing it. 4. **Check for independence** — Six sources that all cite the same original are one source. This is the most common way a false claim becomes "well established". 5. **Track claim to evidence** — Every assertion in the output must be traceable to a source you read, or marked as an inference. 6. **State what you could not establish** — This is the most valuable part of the output and it is nearly always omitted.
**Decomposition and honest synthesis:**
## Question Should a six-person team with four services and no dedicated ops engineer adopt Kubernetes, or use a managed container service? ## Sub-questions 1. What is the operational burden of a managed Kubernetes cluster, measured rather than asserted? 2. What capabilities does Kubernetes provide that a managed container service does not, and does this team need them? 3. What is the cost difference at this scale? 4. What is the migration cost if the initial choice turns out to be wrong? ## Findings **1. Operational burden — MODERATE CONFIDENCE** Managed Kubernetes removes control-plane operation but not cluster operation: upgrades, node management, ingress, certificates, and RBAC remain. Public accounts from teams of this size consistently report 0.25-0.5 FTE of ongoing maintenance [1][2][4]. Caveat: these are self-reported, from teams who chose to write about it, and that is a self-selected population. Teams for whom it went smoothly may be less likely to publish. Treat 0.25-0.5 FTE as an upper-middle estimate, not a median. **2. Capabilities — HIGH CONFIDENCE** Kubernetes provides multi-tenancy, sophisticated scheduling, and a large ecosystem. For four stateless services with no bin-packing requirement, none of these is load-bearing. [Verified against the team's actual requirements document.] **3. Cost — HIGH CONFIDENCE** Managed Kubernetes: ~$73/month control plane + nodes. A managed container service at this scale: comparable compute cost, no control-plane fee. The difference is not material. Cost is not a deciding factor. **4. Migration cost — LOW CONFIDENCE** I could not find good data on the cost of migrating from a managed container service TO Kubernetes later. Anecdotally it is described as "a few weeks", but I found no account with enough detail to verify. This is the weakest part of the analysis and it matters, because it is the argument for adopting Kubernetes pre-emptively. ## Conclusion The evidence supports the managed container service for this team: the capabilities that justify Kubernetes are not needed, cost is neutral, and the operational burden is real and falls on a team with no one to absorb it. The one argument I cannot rebut is "we will need Kubernetes later and migrating will be expensive" — because I could not establish the migration cost. If that number turned out to be large, the conclusion could change. ## Sources [1] ... (primary, read in full) [2] ... (primary) [3] NOT USED — a vendor blo
A curated library of 137 production-grade skills for Claude and other AI coding agents. Every skill follows one structure, speaks with one voice, and earns its place by changing what the agent does.
Use when writing project instructions for a coding agent (CLAUDE.md, AGENTS.md, or equivalent). Covers what belongs in them, what…
Use when an agent needs state that survives a session or a context compaction. Covers what to persist, file-based memory,…
Use when automating agent behavior with lifecycle hooks. Covers hook events, deterministic enforcement of rules the model should…
Use when packaging skills, commands, hooks, and MCP servers into a distributable plugin. Covers manifest structure, bundling,…
Use when writing a new skill for an AI agent. Covers scoping, description writing for reliable triggering, progressive…
Use when reviewing or improving an existing agent skill. Covers triggering accuracy, content quality, redundancy with the base…
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…
Ask which skill or flow fits your situation. A router over the skills in this repo.