Agent skill

Modifying Instructions

by epam in epam/cloud-pipeline

Required before adding or changing anything an agent reads — a convention in AGENTS.md, a procedure as a skill, a pattern-scoped rule.

Apache-2.0Auto-check: warningsAgent Workflows

Install Modifying Instructions

The automated check flagged lines worth reading first. See the safety section below.

skills CLI
$ npx skills add epam/cloud-pipeline --skill modifying-instructions -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install epam/cloud-pipeline modifying-instructions --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/epam/cloud-pipeline.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/modifying-instructions .claude/skills/modifying-instructions && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
modifying-instructions
GitHub stars
162
Token cost
~2.2k tokens
SKILL.md length
1,136 words
Files
3 (incl. scripts)
Skills in repo
8
Repo updated
First seen
Licence
Apache-2.0

At a glance

Required before adding or changing anything an agent reads — a convention in AGENTS.md, a procedure as a skill, a pattern-scoped rule.

  • Tasks that involve Agent instruction files
  • SKILL.md covers Where a thing goes, Voice, What each vendor actually does and AGENTS.md, plus 4 more sections
  • Runs Shell scripts from its folder

What it does

Modifying Instructions is an agent skill from epam/cloud-pipeline. Required before adding or changing anything an agent reads — a convention in AGENTS.md, a procedure as a skill, a pattern-scoped rule. Holds which of those a thing belongs in, the wiring each needs before it loads at all, and what to keep out of them.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including scripts (for example `scripts/claude-md-twins.sh` and `scripts/verify-instructions.sh`).

It sits in Agent Workflows, covering Agent instruction files. The repository describes itself as: Cloud agnostic genomics analysis, scientific computation and storage platform. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Agent instruction files

Example prompts

  • “/modifying-instructions”

Requirements

  • A Bash shell

What it can do on your machine

Read from SKILL.md and the folder at commit 5017688. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Shell), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Modifying Instructions loads about 2.2k tokens when it runs. Until then it costs about 69 tokens; SKILL.md has 1,136 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~69
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: warnings

The automated check found patterns that need a careful read before installing.

  • NoteMentions a .env fileSKILL.md:132
    - **Repo-relative** shapes (`.env`, `.env.local`, `.env.<environment>.local`, `secrets/`, keystore/key
  • WarningMentions a credentials file (SSH keys, cloud or package-manager tokens)SKILL.md:134
    - **Home credential stores** (`~/.ssh`, `~/.aws`, …) stay in `AGENTS.md` and in Claude `Read(~/...)`

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from epam/cloud-pipeline at commit 5017688, republished under its Apache-2.0 licence (© epam). 1,136 words, ~2,170 tokens.

Download SKILL.mdSave it as .claude/skills/modifying-instructions/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
modifying-instructions
description
Required before adding or changing anything an agent reads — a convention in AGENTS.md, a procedure as a skill, a pattern-scoped rule. Holds which of those a thing belongs in, the wiring each needs before it loads at all, and what to keep out of them.

Modifying agent instructions

Where a thing goes

The thing you haveWhere
A fact or convention, true for a whole subtreeAGENTS.md, or <dir>/AGENTS.md
A multi-step procedure, needed occasionallya skill — .agents/skills/<name>/SKILL.md
A constraint tied to a file pattern no directory can expressa rule — one file per vendor, sharing a stem
A script an agent runs deliberatelyscripts/ inside the skill it supports; others may run it too
Setup and usage detail for humansthe module's README.md
The team's own process — stages, labels, naming, what a change owesCONTRIBUTIONS.md

Behaviour is vendor-neutral. Skills and AGENTS.md name capabilities ("the session's browser tool", "a fresh agent", "if you cannot ask"). Vendor commands, config paths and permission files belong only in this skill and in the pointer files it names.

CONTRIBUTIONS.md is written for people. Agents read the conventions it holds and point at it. An agent-only rule never goes into it — not the steps an agent walks, not what it asks for, not what it does unattended, not a table of what each vendor supports.

Claude-only surfaces that have no portable equivalent — .claude/settings.json allow/deny/ask, .claude/agents/, Claude hooks — stay in .claude/ and are extra enforcement, not the spec. Prefer a skill over a Claude subagent definition.

AGENTS.md loads on every task in the repository; a skill loads only on the tasks matching its description. Prefer a skill whenever the content is a procedure. In AGENTS.md treat deletion as the default: cut anything derivable from the file it describes. When you cut something a reader still needs, move it.

Voice

State a rule directly, imperative — never "this skill/file says" about itself.

Don't narrate the reasoning behind a decision, and don't cite .claude/settings.json or another instruction file as the authority for a rule stated here.

Illustrate a rule with what decides the outcome, not a directory's current state — repository structure and coupling facts in root AGENTS.md are the exception, named directly.

Cut removed content outright, with no "X was removed" or "X is not relevant here" left behind.

What each vendor actually does

Vendor is the tool an agent runs inside — Claude Code, Cursor, Copilot. Copilot is two of them: in the editor, and on GitHub, assigned to an issue or a pull request. They read the same files but index different ones, so the column below says which. client in this repository is the GUI module and nothing else; never use that word for a tool.

Where a vendor has no equivalent, the cell is empty — never invent a file it cannot enforce.

ConcernShared (the spec)Claude CodeCursorCopilot
ConventionsAGENTS.md, nested the same wayCLAUDE.md twin (required; Claude does not read AGENTS.md)native; combines parent into child. .cursor/rules/00-agents.mdc keeps the root file in playnative, nested files included, plus .github/copilot-instructions.md repository-wide
Skills.agents/skills/symlink .claude/skills → that directorynative from .agents/skills/native in the editor; on GitHub, no skill index — only a file AGENTS.md or copilot-instructions.md told it to open
Deny-read (repo files)AGENTS.md list + .gitignorepermissions.deny Read(...).cursorignorenone beyond the prose
Deny-read (~/ credential stores)named in AGENTS.mdpermissions.deny Read(~/...)not applicable (those paths are outside the workspace)none
Deny-shell (pipectl, force-push, …)AGENTS.md anti-patternspermissions.deny Bash(...)session sandbox; not a repo filenone
Browserverify-client-livePlaywright MCP if already configuredthe IDE browser MCP, if the session has itoften none → skip
Fresh reviewa new agent, given the diff, not the author's conversation/code-review if that command existsa fresh subagentCopilot code review on the PR, otherwise a declared self-review
Unattendedyou cannot get an answer before the next stepsamesamesame

AGENTS.md

Root AGENTS.md is the source of truth for conventions. Every other instruction file points at it or scopes it to a pattern; none of them restate it.

Any directory may carry one, and they nest. A module earns one when it departs from the repository default — a live database, a different test runner, a suite that only partly runs. Most Java modules need none. Keep the root file's claims about a subtree thin: if the two disagree the subtree file wins.

Every AGENTS.md needs a CLAUDE.md beside it whose entire contents are the import:

@AGENTS.md

A script writes and stages the twin — with no arguments, for every AGENTS.md in the working tree; given directories, only those:

bash
.agents/skills/modifying-instructions/scripts/claude-md-twins.sh
.agents/skills/modifying-instructions/scripts/claude-md-twins.sh client/test

Write the AGENTS.md first: that one is yours. A CLAUDE.md already holding something other than the import is reported and left alone, since replacing it would throw away what a person wrote.

Show full SKILL.md (393 more words)Show less

Skills

.agents/skills/ is the source of truth. The .claude/skills link is committed, and .agents/skills/README.md has the fix where a checkout loses it. A skill that must reach Copilot on GitHub is named from AGENTS.md or .github/copilot-instructions.md, as a file to open.

Frontmatter takes only name, description, license, compatibility, metadata and allowed-tools; anything else is a hard error when a skill is packaged. name must equal the directory name.

The description is the whole index for vendors that index skills. One that describes the contents but not the occasion never loads.

Keep SKILL.md short. Write what this repository does differently.

Pattern-scoped rules

What earns one is a glob no single directory can express — crossing sibling trees, or matching by extension. Anything one directory covers belongs in that directory's AGENTS.md, which says the same thing to every vendor, so check the nearest common ancestor first.

One rule is three files sharing a stem, each carrying the same prose — client-components.md, client-components.mdc, client-components.instructions.md. Write all three yourself; where one is missing the rule is off for that vendor. Only the glob field differs:

FileGlob field
.claude/rules/<name>.mdpaths: — a YAML list
.cursor/rules/<name>.mdcglobs:, plus alwaysApply: false
.github/instructions/<name>.instructions.mdapplyTo: — one quoted glob, comma-separated for several

In .cursor/rules/ an <nn>- prefix marks an always-applied pointer at AGENTS.md instead, and that file stands alone.

The secret blocklists

AGENTS.md names the paths agents must not read. Enforcement is extra and incomplete:

  • Repo-relative shapes (.env, .env.local, .env.<environment>.local, secrets/, keystore/key suffixes) go in permissions.deny in .claude/settings.json, .cursorignore, and .gitignore.
  • Home credential stores (~/.ssh, ~/.aws, …) stay in AGENTS.md and in Claude Read(~/...) denies. They do not belong in .cursorignore.

Neither deny-read format supports negation, so the rule is a naming convention rather than a list with .env.example carved back out. Extending protection means adding a repo-relative pattern to all three files, or a ~/ path to AGENTS.md and Claude's deny list.

Shell denies live in AGENTS.md anti-patterns for every vendor. Claude may also list them under permissions.deny.

Verify

bash
.agents/skills/modifying-instructions/scripts/verify-instructions.sh

It checks the gradle modules these files name against settings.gradle, that every AGENTS.md has its Claude twin, that every shape in .cursorignore is also denied to Claude Code and gitignored, that every rule stem exists in all three vendor directories, and that every skill would load. CI runs the same command from .github/workflows/agent-instructions.yml. It cannot check prose against reality: a stale paraphrase passes. Point rather than copy.

© epam, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts) in .agents/skills/modifying-instructions of epam/cloud-pipeline.

  • SKILL.md
  • scripts/claude-md-twins.sh
  • scripts/verify-instructions.sh

Open the folder on GitHubat commit 5017688

Compare with similar skills

Modifying Instructions next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Modifying Instructions compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Modifying Instructions this skillepam/cloud-pipeline162—~2.2kAutomated safety check: WarnApache-2.0
Using Agent Skillsaddyosmani/agent-skills102k4 repos~2.4kAutomated safety check: PassMIT
Claude ReflectBayramAnnakov/claude-reflect1.7k2 repos~627Automated safety check: PassMIT
Neat-Freak Knowledge CloseoutKKKKhazix/khazix-skills21k—~1.9kAutomated safety check: PassMIT
Task Observerrebelytics/one-skill-to-rule-them-all3.2k1 repos~12kAutomated safety check: PassCC-BY-4.0
Writing For Agentsbestofjs/bestofjs3.1k17 repos~2.7kAutomated safety check: PassMIT

Similar skills

  • Using Agent Skills

    addyosmani/agent-skills

    Meta-skill for choosing which workflow skill fits the task at hand, plus always-on habits: surface assumptions, stop on confusion, push back, keep it simple and stay in scope.

    102k GitHub starsUsed in 4 repos~2.4k tokens
    Agent WorkflowsAuto-check passed
  • Claude Reflect

    BayramAnnakov/claude-reflect

    Self-learning system that captures corrections during sessions and reminds users to run /reflect to update CLAUDE.md.

    1.7k GitHub starsUsed in 2 repos~627 tokens
    Agent WorkflowsAuto-check passed
  • Neat-Freak Knowledge Closeout

    KKKKhazix/khazix-skills

    Brings project docs, agent rule files, authorized memory and leftover workspace files back in line with what the code and runtime actually do at the end of a work session.

    21k GitHub stars~1.9k tokensUpdated 6 days ago
    Agent WorkflowsAuto-check passed
  • Task Observer

    rebelytics/one-skill-to-rule-them-all

    Monitors task execution for skill improvement opportunities.

    3.2k GitHub starsUsed in 1 repo~12k tokens
    Agent WorkflowsAuto-check passed
  • Writing For Agents

    bestofjs/bestofjs

    Writing documents for agents. An agent skill from bestofjs/bestofjs.

    3.1k GitHub starsUsed in 17 repos~2.7k tokens
    Agent WorkflowsAuto-check passed
  • SkillOpt Sleep Cycle

    microsoft/SkillOpt

    Official

    Runs an on-demand or nightly sleep cycle that reviews past Claude Code sessions and proposes validated updates to CLAUDE.md and skills.

    18k GitHub stars~2.3k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from epam/cloud-pipeline

All 8 skills in this repo
  • Verify Client Live

    epam/cloud-pipeline

    Open a user-visible client/ change in a browser against a real Cloud Pipeline deployment.

    162 GitHub stars~511 tokensUpdated yesterday
    Auto-check passed
  • Configure Dev Environment

    epam/cloud-pipeline

    Learn which toolchains and environments this workstation has and how to invoke them, or set them up when they are missing.

    162 GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed
  • Commit Changes

    epam/cloud-pipeline

    Required before you commit, push or open a pull request here, asked or not.

    162 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Plan Change

    epam/cloud-pipeline

    Plan the work before you edit — its phases, the model and effort each takes, and whether it is worth a plan file with a ledger beside it.

    162 GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed
  • Verify Changes

    epam/cloud-pipeline

    Find and run the checks a change owes, from what it touches and what that can reach.

    162 GitHub stars~748 tokensUpdated yesterday
    Auto-check passed
  • Implement Task

    epam/cloud-pipeline

    Start here before the first edit of any file — a one-liner and a docs change included.

    162 GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Modifying Instructions

What does Modifying Instructions do?

Required before adding or changing anything an agent reads — a convention in AGENTS.md, a procedure as a skill, a pattern-scoped rule. Modifying Instructions is an agent skill from epam/cloud-pipeline.md, a procedure as a skill, a pattern-scoped rule.

When should I use Modifying Instructions?

Modifying Instructions fits situations like: tasks that involve Agent instruction files.

How do I install Modifying Instructions in Claude Code?

Run `npx skills add epam/cloud-pipeline --skill modifying-instructions -a claude-code`. Or copy the skill folder (.agents/skills/modifying-instructions in epam/cloud-pipeline) into .claude/skills/modifying-instructions in your project. Claude Code loads it when a task matches its description.

How do I install Modifying Instructions in Codex?

Run `npx skills add epam/cloud-pipeline --skill modifying-instructions -a codex`. Or copy the skill folder (.agents/skills/modifying-instructions in epam/cloud-pipeline) into .agents/skills/modifying-instructions in your project. Codex loads it when a task matches its description.

Can I use Modifying Instructions in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add epam/cloud-pipeline --skill modifying-instructions -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/modifying-instructions, .gemini/skills/modifying-instructions, .github/skills/modifying-instructions and .opencode/skills/modifying-instructions in your project.

What does Modifying Instructions need to run?

Going by SKILL.md and its folder, Modifying Instructions needs a shell for the scripts in its folder. Our summary lists: A Bash shell.

Does Modifying Instructions access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Modifying Instructions safe to install?

Our automated static check of SKILL.md flagged 1 warning(s): mentions a credentials file (ssh keys, cloud or package-manager tokens). Read the flagged lines before installing; the check is not a guarantee either way. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Modifying Instructions use?

Modifying Instructions is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Modifying Instructions use?

About 2.2k tokens (SKILL.md is roughly 8.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Modifying Instructions?

Skills that share tags, products or a category with Modifying Instructions: Using Agent Skills (addyosmani/agent-skills, 102k stars), Claude Reflect (BayramAnnakov/claude-reflect, 1.7k stars), Neat-Freak Knowledge Closeout (KKKKhazix/khazix-skills, 21k stars) and Task Observer (rebelytics/one-skill-to-rule-them-all, 3.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Modifying Instructions?

epam (a GitHub organization) maintains it in epam/cloud-pipeline, which has 162 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 6, 2026.

Source: epam/cloud-pipeline on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.