Run any Skill in Manus with one click

$pwd:

agent-setup-maintenance

Name: Agent Setup Maintenance
Author: langfuse

// Shared workflow for editing Langfuse's repo-owned agent setup under `.agents/`. Use when changing AGENTS files, shared skills, `.agents/config.json`, generated shim behavior, provider discovery paths, or install-time agent sync.

Run Skill in Manus

$ git log --oneline --stat

stars:27,778

forks:2,843

updated:May 14, 2026 at 16:31

SKILL.md

readonly

name	agent-setup-maintenance
description	Shared workflow for editing Langfuse's repo-owned agent setup under `.agents/`. Use when changing AGENTS files, shared skills, `.agents/config.json`, generated 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 and CLAUDE.md as discovery symlinks; do not turn them back into manually maintained copies.
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 and router-like. 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, update skills/README.md and link it from root AGENTS.md if it changes the default reusable workflow.
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

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.

related-skills.json

same repository

pnpm-upgrade-package.md

from "langfuse/langfuse"

Use when upgrading a dependency in this pnpm workspace, including requests to bump a package to a specific version, compare the registry latest version with the latest version installable under the current minimum-release-age window, or decide whether minimumReleaseAgeExclude in pnpm-workspace.yaml must change. Ask the user for the package name or target version when either is missing.

2026-05-1927.8k

skill-creator.md

from "langfuse/langfuse"

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Codex's capabilities with specialized knowledge, workflows, or tool integrations.

2026-05-1427.8k

datadog-query-recipes.md

from "langfuse/langfuse"

Langfuse-specific Datadog query recipes for production telemetry research. Use when asked to investigate tenant or project activity, public API endpoint usage, queue consumer behavior, spans, logs, metrics, or ad hoc production questions across prod-us, prod-eu, prod-hipaa, and prod-jp. This skill is for reusable query shapes and measured research; pair it with debug-issue-with-datadog when the task is an incident or root-cause analysis.

2026-05-1127.8k

debug-issue-with-datadog.md

from "langfuse/langfuse"

Debug a user-reported issue, Linear ticket, or incident report by combining Datadog (APM, logs, metrics) with the Langfuse repo to establish a root cause. Use when given a Linear issue URL/ID (e.g. LFE-XXXX), a GitHub issue, or a pasted error/report and asked to investigate, root-cause, or triage. Produces a structured analysis — error breakdown, hypothesis-by-class, suggested patches with code references.

2026-05-1127.8k

detect-prod-regressions.md

from "langfuse/langfuse"

Proactively detect production regressions in Langfuse by comparing recent Datadog errors, error logs, error spans, and API route latency signals against baseline benchmarks or traces across prod-us, prod-eu, prod-hipaa, and prod-jp. Use when asked to sweep production for new bugs, catch regressions early, catch low-occurrence coding bugs or edge cases, compare recent changes to Datadog measurements, or prepare measured production evidence for human review before any optional Linear handoff.

2026-05-1127.8k

backend-dev-guidelines.md

from "langfuse/langfuse"

Shared backend guide for Langfuse's Next.js, tRPC, BullMQ, and TypeScript monorepo. Use when creating or reviewing tRPC routers, public REST endpoints, BullMQ queue processors, backend services, middleware, Prisma or ClickHouse data access, OpenTelemetry instrumentation, Zod validation, env configuration, or backend tests across web, worker, or packages/shared.

2026-05-1127.8k

package.json

"author": "langfuse"

"repository": "langfuse/langfuse"

View GitHub Repository View Creator Repositories

$ install --global

$ download --local

Run Skill in Manus

$ useful --forSOC

Software DevelopersComputer and Mathematical Occupations15-1252L4

name	agent-setup-maintenance
description	Shared workflow for editing Langfuse's repo-owned agent setup under `.agents/`. Use when changing AGENTS files, shared skills, `.agents/config.json`, generated 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 and CLAUDE.md as discovery symlinks; do not turn them back into manually maintained copies.
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 and router-like. 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, update skills/README.md and link it from root AGENTS.md if it changes the default reusable workflow.
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

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.

agent-setup-maintenance

Agent Setup Maintenance

Start Here

Workflow

Docker / Install-Time Constraint

Required Verification

Design Rules

More from this repository

More from this repository

Agent Setup Maintenance

Start Here

Workflow

Docker / Install-Time Constraint

Required Verification

Design Rules