add-global-mode-target
- Repo stars 15
- Author updated Live
- Author repo agentsmesh
- Domain
- Documentation
- Compatible agents
-
- Claude Code
- Cursor
- Cline
- Codex
- Windsurf
- Gemini CLI
- +20
- Trust score
- 88 / 100 · community maintained
- Author / version / license
- @sampleXbro · no license declared
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No special requirements
- Permissions
-
- Read-only
- Write / modify
- Network behavior
- Local-only
- Install commands
- 26 variants
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
---
name: add-global-mode-target
description: Use when adding global mode support for one existing agentsmesh target from a target-structure/g…
category: documentation
runtime: no special runtime
---
# add-global-mode-target output preview
## PART A: Task fit
- Use case: Use when adding global mode support for one existing agentsmesh target from a target-structure/global-path doc. Covers contract extraction from docs, descriptor.global layout wiring, generator/import/reference-rewrite touchpoints, strict tests, docs updates, and final verification for one target at a time..
- Inputs: target material, constraints, expected output, and acceptance criteria.
- Evidence boundary: follow “Purpose / When To Use / Do Not Use This Skill For” and do not present inference as author intent.
## PART B: Execution result
- **01** The card summarizes the use case; runtime output centers on “Use when adding global mode support for one existing agentsmesh target from a target-structure/global-path doc. Covers contract extraction from docs, descriptor.global layout wiring, generator/import/reference-rewrite touchpoints, strict tests, docs updates, and final verification for one target at a time.”.
- **02** When the source has headings, the agent prioritizes “Purpose / When To Use / Do Not Use This Skill For” so the result follows the author’s structure.
- **03** Typical output includes task judgment, concrete steps, required commands or file edits, validation, and follow-up options.
- **04** Risk context follows the fingerprint: read files, write/modify files; mostly runs locally; usually needs no extra API key.
## Running Rules
- read files, write/modify files; mostly runs locally; usually needs no extra API key.
- Validate with a small sample before expanding scope.
- Return the result, validation criteria, and next iteration options. The source does not require a stable slash command. After installation, invoke the skill by name and describe the task.
Name target files or source material, expected output, forbidden changes, and whether network or shell access is allowed. Permission fingerprint: read files, write/modify files.
Start with a small task and check whether the result follows “Purpose / When To Use / Do Not Use This Skill For”. Inspect diffs, logs, previews, or tests before expanding scope.
Confirm the final output includes a concrete result, evidence, and next action. If it stays generic, tighten inputs, boundaries, and acceptance criteria.
---
name: add-global-mode-target
description: Use when adding global mode support for one existing agentsmesh target from a target-structure/g…
category: documentation
source: sampleXbro/agentsmesh
---
# add-global-mode-target
## When to use
- Use when adding global mode support for one existing agentsmesh target from a target-structure/global-path doc. Covers…
- Use it when the task has clear inputs, repeatable steps, and validation criteria.
## What to provide
- Target material, scope, expected result, and forbidden changes.
- Whether network, commands, file writes, or external services are allowed.
## Execution rules
- Organize steps around “Purpose / When To Use / Do Not Use This Skill For” and keep inference separate from source facts.
- read files, write/modify files; mostly runs locally; usually needs no extra API key.
- Validate with a small sample before expanding the task.
## Output requirements
- Return the deliverable, key evidence, validation method, and next action.
- Mark missing information as unknown; do not invent commands, platforms, or dependencies. The author source anchors workflow facts; repository files anchor sources and commands; Fluxly only adds fit, limitations, and quality judgment.
skill "add-global-mode-target" {
input -> user goal + target files + boundaries + acceptance criteria
context -> Purpose / When To Use / Do Not Use This Skill For
rules -> SKILL.md triggers / order / output contract
runtime -> no special runtime | read files, write/modify files | mostly runs locally
guardrails -> usually needs no extra API key + small-sample validation + diff/log review
output -> copyable result + checklist + next iteration
} Purpose
Add Global Mode Target
Use this skill when the task is to add global mode support for one existing target after you have a target-specific document that describes the native global file paths and behavior.
Read .agentsmesh/skills/add-global-mode-target/references/global-mode-target-checklist.md before editing code. Treat it as the minimum implementation and QA checklist.
When To Use
- The target already exists in
src/targets/<target>/ - You have a target doc with native global paths or global behavior
- The repository-wide global-mode foundation already exists (
init|install|generate|import|diff|lint|watch|check|merge|matrix --global) - The work is scoped to one target at a time
Do Not Use This Skill For
- Adding a brand-new target from scratch
- Defining the shared global-mode architecture for the first time
- Guessing a target's global behavior without a concrete doc or official source
Use add-agent-target for new targets. Use this skill only for the per-target global-mode pass.
Non-Negotiable Rules
MUST
- Start from the target doc and verify it against the live target implementation.
- Treat current code as the source of truth for project-mode behavior; preserve it unless the target doc requires a change.
- Write failing tests first for every new global-mode behavior.
- Keep the change target-scoped. Do not scatter new target-specific branches through shared code if descriptor metadata can carry the behavior.
- Add or update
descriptor.globaland keep project/global layout semantics explicit. - Verify link rewriting and import normalization for the target's global paths, not just generation paths.
- Test unsupported global features explicitly. If the target has no meaningful native global support, encode that and test the skip/warning behavior.
- Update docs if the supported-tools matrix, README, or global-mode docs change.
- Run the full verification stack before claiming completion.
MUST NOT
- Do not infer global paths from project-mode paths.
- Do not hardcode the target's global paths in shared cleanup or reference code when descriptor metadata can own them.
- Do not stop at “files generate”; global import, reference rewriting, and stale cleanup must also be checked when applicable.
- Do not silently mark a target as globally supported if only a subset of features work natively.
Workflow
Extract the contract from the doc.
- Record the target's native global root.
- Record which features are globally supported: rules, commands, agents, skills, MCP, hooks, ignore, permissions.
- Record root-instruction behavior, fallback paths, legacy paths, and any GUI-only/unsupported areas.
- Record whether import from global files is meaningful and lossless.
Cross-check the live target implementation.
- Read
src/targets/<target>/index.ts,constants.ts,generator.ts,importer.ts, andlinter.ts. - Identify the current project layout in
descriptor.project. - Identify where global behavior can reuse the same structure and where it cannot.
- Read
Write failing tests first.
- Add unit tests for target layout metadata (
descriptor.global, supported/unsupported features). - Add generation tests for global paths and root artifacts.
- Add import/reference-rewrite tests if the target can import from global files.
- Add stale-cleanup coverage if managed outputs differ from project mode.
- Add command/integration coverage that proves the existing
--globalCLI surface works for the new target where applicable.
- Add unit tests for target layout metadata (
Implement the target-global layout.
- Prefer target metadata over shared branching.
- Fill
descriptor.globalfor supported targets. - Keep managed outputs, root instruction paths, and path resolvers explicit.
- If only some features are global, encode that precisely and keep unsupported ones absent or skipped.
Wire shared behavior only where necessary.
- Update shared scope-aware path or import code only if the target truly needs it.
- Keep shared changes generic and descriptor-driven.
- If the target doc reveals a shared architectural gap, fix the gap once rather than adding one-off target branches.
- Do not re-architect CLI scope handling unless the target proves a real shared gap.
Update docs and matrix surfaces.
- Update
README.mdandwebsite/src/content/docs/reference/supported-tools.mdxif support levels or notes change. - Update
docs/plan-global-mode.mdif the target behavior clarifies the implementation contract.
- Update
Verify and QA.
- Run targeted tests during iteration.
- Run the full verification stack at the end.
- Apply the local
post-feature-qaskill before marking the work done.
Required Touchpoints
- Target descriptor and layout metadata:
src/targets/<target>/index.ts - Shared target lookup/path helpers:
src/targets/catalog/builtin-targets.tssrc/core/reference/map-targets.tssrc/core/reference/map.ts - If the target imports or rewrites links in global scope:
src/core/reference/rewriter.tssrc/core/reference/output-source-map.tssrc/core/reference/import-rewriter.tssrc/core/reference/import-map-builders.ts - If managed output ownership changes:
src/core/generate/stale-cleanup.ts - If the target needs command-surface proof:
tests/unit/cli/commands/*.test.tstests/integration/*global*.test.ts
Read the checklist reference for the full test and review matrix.
Required Verification
pnpm lintpnpm typecheckpnpm buildpnpm test
Add narrower unit/integration/e2e commands while iterating, but do not skip the full stack.
Completion Standard
The task is not done until all of the following are true:
- The target's global contract is derived from the provided doc and encoded in code, not left implicit.
descriptor.globalis either implemented correctly or omitted intentionally for unsupported targets.- Global generation paths are tested.
- Global import and reference rewriting are tested when the target supports them.
- Managed outputs and stale cleanup are correct for the target's global footprint.
- Docs and support matrix entries are current.
- Full verification passes.
Decide Fit First
Design Intent
How To Use It
Boundaries And Review