m-hosseinpour/agent-skills

curating-global-instructions

Use when adding to, trimming or reorganizing the instruction file loaded into every session whatever the project — the global CLAUDE.md, AGENTS.md, or whatever plays that role — or when it has grown past what a session can hold.

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/m-hosseinpour/agent-skills --skill curating-global-instructions

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

Curating Global Instructions

The global instruction file is read at the start of every session, whatever the project. Its length is a cost paid by every session that follows, so it should hold what governs the work: rules, invariants and decisions that must not be re-derived.

Core principle: every section is either a rule — something that must fire unconditionally — or a technique, which needs a trigger. Rules stay. Techniques move to a skill, where they load when wanted.

The one question

Ask it of every section, and of everything you are about to add:

Is this a rule, or a technique?

A rule — a constraint, a decision, a precedence — fires whether or not anything else loads. It stays. A technique — how to do something, once you know you are doing it — has a trigger, and belongs in a skill. Adding without asking this is how the file grows; trimming without asking it is how a rule disappears.

Before moving anything to a skill

Compare against the skill's BODY, not its description. A description answers "should I open this?"; it does not answer "what is inside?". A section is a duplicate only if the body already carries it — and then it is pure duplication, however useful it reads.

Test the trigger, honestly. Content may move only when the trigger names a situation the agent can recognise from the request: "I am building a UI" and "review this diff" pass. It fails when the trigger requires the skill's own diagnosis first — "the code feels brittle", "cleanup looks missing" — because the agent cannot know it needs the skill until it has already learned what the skill teaches. Where the trigger is weak, keep the rule and point at the skill in one line.

Write the new skill's description as a trigger, not a summary — a summary becomes a shortcut the agent follows instead of reading the body.

When the skill you are drafting is more than a few lines, read writing-skills first if it is available: it covers naming, placement and how to check the result.

What never moves

  • A decision no skill can enforce. A skill can be read; it cannot compel.
  • A rule that contradicts a harness default — this file is the only place that can override one.
  • The single failure that costs most when no skill is opened. State it outright even though a skill covers it; that duplication is deliberate.

Working the file

Measure, do not guess. Count each section before and after. "Feels long" is not a measurement, and a total that moved without a per-section number cannot be reported.

One move at a time, verified. After moving a section, grep the names, paths and terms it carried — an orphaned reference to a section that no longer exists is the failure this work produces.

Replace or delete a superseded line; never banner it. A line explaining what the file used to say is itself a cost paid every session.

Common mistakes

MistakeFix
Trimming by feel, or toward a target percentageMeasure per section and report the numbers
Deleting a section because a skill "covers that area"Read the body — areas are not contents
Moving content whose trigger needs the skill's own diagnosis (e.g. "the code feels brittle")The agent cannot recognise the problem until the content has taught it; keep the rule
A description that summarizes the new skill's stepsMake it a trigger; see writing-skills
来自同一仓库

更多 Skills

全部 Skills
m-hosseinpour
社区

designing-persian-rtl-web-ui

Use when building, changing, or checking a Persian (Farsi) web interface — including right-to-left layout, typography, UI copy, numerals, responsive behavior, or dark mode — and before calling Persian UI work done. Not for RTL-only work in non-Persian interfaces.

1小时安装量
2
GitHub Stars
0
最近更新
11月15日
m-hosseinpour
社区

dispatching-parallel-agents

Use when delegation is available and allowed and a task has multiple substantial workstreams that may be independent, when parallel agent work is requested, or before running a subagent alongside your own work or other subagents. Not for small multi-step tasks, parallel tool calls, or one delegate you will simply wait for.

1小时安装量
2
GitHub Stars
0
最近更新
11月15日
m-hosseinpour
社区

research-with-evidence

Use when researching a question across multiple sources, doing in-depth web research, comparing options using external evidence, investigating conflicting claims, or checking the substantive claims and sources of a research report. Not for a simple factual lookup, explanation from already-sufficient evidence, translation or editing without fact-checking, code-change review, or diagnosing a concrete software failure.

1小时安装量
2
GitHub Stars
0
最近更新
11月15日
m-hosseinpour
社区

reviewing-code-changes

Use when starting a review of a PR, merge request, branch, commit range, patch, or uncommitted changes for defects, regressions, requirement conformance, or merge readiness, including direct instructions to review and test changes against a ticket or acceptance criteria; or before completing consequential changes to behavior, public contracts, security, or persisted data. Not for test-only runs, unchanged-code audits, explanation-only walkthroughs, formatting existing findings, receiving review

1小时安装量
2
GitHub Stars
0
最近更新
11月15日