
agent-setup-maintenance
β 30,400by langfuse Β· part of langfuse/langfuse
Use this skill when changing the shared agent setup for the repository.
This is the playbook your agent receives when the skill activates β you don't need to read it to use the skill, but it's here to audit before installing.
by langfuse
Use this skill when changing the shared agent setup for the repository.
npx skills add https://github.com/langfuse/langfuse --skill agent-setup-maintenance
Download ZIPGitHub30.4k
Start Here
-
Read
../../README.mdfor the shared config and shim model. -
Read root
../../AGENTS.mdfor 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.mjsbefore changing generated outputs or provider discovery behavior. -
Inspect
../../../scripts/postinstall.shand../../../package.jsonwhen changing install-time sync behavior.
Workflow
-
Edit the canonical files under
.agents/, not generated provider outputs. -
Keep root
AGENTS.mdandCLAUDE.mdas discovery symlinks; do not turn them back into manually maintained copies. -
Treat tool-specific directories such as
.claude/,.cursor/,.codex/,.vscode/, and.mcp.jsonas generated discovery surfaces unless the tool requires a truly tool-specific feature. -
Keep root
AGENTS.mdconcise. Move detailed or conditional workflows into shared skills or packageAGENTS.mdfiles. -
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.mdor shared skill. -
When adding or changing a shared skill, keep
SKILL.mdas the entrypoint; do not add skill-by-skill links to rootAGENTS.md. -
When shared setup behavior changes materially, update
README.mdand contributor-facing docs in the same PR.
Required Verification
Run after changing shared agent setup:
-
pnpm run agents:sync -
pnpm run agents:check
Run additional verification when relevant:
-
pnpm run postinstallwhen 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.
npx skills add https://github.com/langfuse/langfuse --skill agent-setup-maintenanceRun this in your project β your agent picks the skill up automatically.
Agent Setup Maintenance
Use this skill when changing the shared agent setup for the repository.
Docker / Install-Time Constraint
-
pnpm installruns in environments that may not contain the full repo source tree. -
In Docker builds, Turbo's pruned install stage can run root
postinstallbeforescripts/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.
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.