Agent Skills › langfuse/langfuse › agent-setup-maintenance

agent-setup-maintenance

GitHub

管理仓库级 Agent 共享配置与技能，规范 .agents/ 目录下的 AGENTS.md、SKILL.md 及同步脚本的维护流程。

.agents/skills/agent-setup-maintenance/SKILL.md langfuse/langfuse

Trigger Scenarios

修改 Agent 共享配置或技能调整安装时同步行为

Install

npx skills add langfuse/langfuse --skill agent-setup-maintenance -g -y

More Options

Non-standard path

npx skills add https://github.com/langfuse/langfuse/tree/main/.agents/skills/agent-setup-maintenance -g -y

Use without installing

npx skills use langfuse/langfuse@agent-setup-maintenance

指定 Agent (Claude Code)

npx skills add langfuse/langfuse --skill agent-setup-maintenance -a claude-code -g -y

安装 repo 全部 skill

npx skills add langfuse/langfuse --all -g -y

预览 repo 内 skill

npx skills add langfuse/langfuse --list

SKILL.md

Frontmatter

{
    "name": "agent-setup-maintenance",
    "description": "Shared workflow for editing Langfuse's repo-owned agent setup under `.agents\/`.\nUse when changing AGENTS files, shared skills, `.agents\/config.json`,\ngenerated shim behavior, provider discovery paths, or install-time agent sync."
}

Agent Setup Maintenance

Use this skill when changing the shared agent setup for the repository.

Start Here

Read ../../README.md for the shared config and shim model.
Read root ../../AGENTS.md for repo-level expectations.
When adding or editing shared skills, use ../skill-creator/SKILL.md, then apply the repo-specific checks in this skill.
Inspect ../../../scripts/agents/sync-agent-shims.mjs before changing generated outputs or provider discovery behavior.
Inspect ../../../scripts/postinstall.sh and ../../../package.json when changing install-time sync behavior.

Workflow

Edit the canonical files under .agents/, not generated provider outputs.
Keep root AGENTS.md as a symlink to .agents/AGENTS.md. Write folder instructions in AGENTS.md directly; do not generate CLAUDE.md companions.
Treat tool-specific directories such as .claude/, .cursor/, .codex/, .vscode/, and .mcp.json as generated discovery surfaces unless the tool requires a truly tool-specific feature.
Keep root AGENTS.md concise. Move detailed or conditional workflows into shared skills or package AGENTS.md files.
Treat developer feedback as a learning loop: when a task reveals a durable repo convention, recurring pitfall, reusable workflow, or verification pattern, update the smallest relevant AGENTS.md or shared skill.
When adding or changing a shared skill, keep SKILL.md as the entrypoint; do not add skill-by-skill links to root AGENTS.md.
When shared setup behavior changes materially, update README.md and contributor-facing docs in the same PR.

Docker / Install-Time Constraint

pnpm install runs in environments that may not contain the full repo source tree.
In Docker builds, Turbo's pruned install stage can run root postinstall before scripts/ and .agents/ are available in the image.
Keep install-time agent setup logic robust in those pruned contexts: skip cleanly when the required repo-owned files are not present.

Required Verification

Run after changing shared agent setup:

pnpm run agents:sync
pnpm run agents:check
node --test scripts/agents/sync-agent-shims.test.mjs when sync behavior changes

Run additional verification when relevant:

pnpm run postinstall when install-time behavior changes
targeted tests for any scripts you changed

Design Rules

Prefer one repo-owned source of truth over duplicated provider-specific files.
Keep shared setup tool-neutral where possible.
Only keep provider-specific files in source control when the provider requires a fixed discovery path or feature that cannot be expressed through the shared setup model.