Index of every page on this site: llms.txt
All skills
launchdarkly avatar

/launchdarkly-automations-archival-settings

@f0ee110 official
Run it yourself

Read and change a LaunchDarkly project's Automations auto-archival settings via the hosted MCP. Auto-archival archives flags that are ready to archive after a grace period, or creates approval requests for them. Use when the user wants to see or change the grace period, approval requirement, run limit, recheck cadence, or notification recipients, turn automatic archival off or on, or asks why a flag was or was not archived automatically. For first-time setup of every Release Autopilot capability, use launchdarkly-release-autopilot-onboarding.

Use this Skill: https://skilld.dev/gh/launchdarkly/ai-tooling/launchdarkly-automations-archival-settings

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈148 tokens for metadata: the name and description. ≈1.9k when used: this file. ≈799 more on demand in 3 files.

Description uses 7.4% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈593 characters, or 7.4%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

LaunchDarkly Automations Auto-archival Settings

You're using a skill that reads and changes a project's auto-archival settings, from the "Automatic archival" section of the project's Settings > Automations page. Auto-archival archives flags without a person in the loop unless approvals are required. Treat every write as production automation with a blast radius.

Prerequisites

This skill requires the remotely hosted LaunchDarkly MCP server.

Required MCP tools:

  • get-automations with section: "archival" and projectKey: the project's archival settings and automationsPage, the link to the project's Automations page.
  • update-automations with projectKey and an archival object: change one or more settings, or turn archival off. Omitted fields keep their stored values. Send archival on its own, without accountWide, repo, or cleanup. It cannot turn archival on (see Turn it on).

Optional: get-projects to pick the project, search-members to resolve notification member IDs (team keys come from the user), get-approval-requests for pending archival approvals.

If get-automations has no section argument, or rejects section, the server has not picked up cleanup and archival yet. Ask the user to reconnect the LaunchDarkly MCP server once. If it still has none, guide the browser steps in references/browser-steps.md instead. Do not invent REST calls.

If a call fails with "automatic archival is not available for this account yet", the account does not have the feature. Tell the user and stop; do not retry or try other tools.

What the settings mean

Durations are in seconds. Show them to the user in hours or days.

Field Meaning
enabled Whether automatic archival runs for the project
graceSeconds How long a flag that is ready to archive waits before it is archived: 1 hour (3600) to 30 days (2592000)
requireApproval true creates an approval request for each flag instead of archiving it directly
maxArchivalsPerRun The most flags one run archives (1 to 100)
watchCadenceSeconds How often watched flags are rechecked for a status change: 1 minute (60) to 7 days (604800)
notifyMemberIds, notifyTeamKeys Fallback members and teams notified about archival activity. They are not owners: flags with no maintainer are never archived automatically
configuredByMemberId, riskAcknowledgedAtSeconds Read-only: who last saved the settings, and when someone confirmed the risk to turn archival on

Core Principles

  1. Confirm before every write. State the current and proposed values, wait for a yes that names the change in this turn, then write. A yes from an earlier turn, or a vague "go ahead", is not enough.
  2. Only a person can turn it on. Turning archival on requires confirming its risk on the Automations page. Never claim you turned it on.
  3. Keep approvals unless asked. Never set requireApproval to false unless the user explicitly asked to archive without approvals. Say that flags will then be archived without review.
  4. Lists replace. notifyMemberIds and notifyTeamKeys replace the whole stored list. To add one recipient, read the current list and send it with the new one.
  5. Shorter means sooner. Lowering graceSeconds or raising maxArchivalsPerRun archives more flags sooner. Say so in the proposal.

Workflows

Read the settings

get-automations with section: "archival" and projectKey. Report whether it is on, the grace period, whether approvals are required, the run limit, and the notification recipients.

Change a setting

  1. Read the settings: get-automations with section: "archival".

  2. Propose the change, for example:

    Automatic archival in project default waits 1 day before archiving a ready flag. Change it to 7 days? Ready flags will stay unarchived for a week before they are archived.

  3. After the user confirms, call update-automations with projectKey, confirm: true, and an archival object holding only the confirmed fields.

  4. The response lists changed and the settings as read back. If it reports a mismatch, or says the settings changed after they were read, show the user the current values from get-automations with section: "archival" and ask again before retrying.

Settings can be changed while archival is off, so a user can set them before a person turns it on.

Turn it off

Propose it ("Turn off automatic archival for project default? No more flags will be archived automatically; flags already archived stay archived."), then update-automations with projectKey, archival: { "enabled": false }, and confirm: true.

Turn it on

The agent cannot turn archival on. If the user asks:

  1. Read the settings: get-automations with section: "archival", and set any other settings they asked for first (see Change a setting).
  2. Give the user automationsPage. In the "Automatic archival" section, they turn on Enable automatic archival and confirm the "Enable automatic archival?" dialog. Turning it on requires permission to archive every flag in the project.
  3. When they say it is done, call get-automations with section: "archival" once and report whether enabled is true. Do not poll.

If update-automations returns applied: false with a nextStep, nothing changed: follow these steps.

Why was (or wasn't) a flag archived automatically?

Read-only. Ask for the flag key if the user did not give one. Then check in this order, and stop at the first cause you can show from a tool result:

  1. get-automations with section: "archival": enabled is false, so archival is off for the project.
  2. get-flags with projectKey and flagKey: the flag has no maintainer (flags with no maintainer are never archived automatically), or it is already archived (archived true; a flag archived automatically has the auto-archived tag).
  3. get-flag-status-across-envs with allEnvs: true, and get-projects with projectKey and fullSettings: true (settings.lifecycle holds the checks and day thresholds for ready to archive): the flag is still evaluated or does not meet those checks, so it is not ready to archive.
  4. requireApproval is true: look for a pending approval request with get-approval-requests.

These tools do not show when a flag became ready to archive or which flags a run picked. If none of the checks above explains it, say the likely causes without claiming either one: it became ready less than graceSeconds ago, or more flags were ready than maxArchivalsPerRun and the rest wait for a later run.

Flags archived this way get the auto-archived tag. "View auto-archived flags" on the Automations page lists them. Do not change settings to try something.

Errors

  • "automatic archival is not available for this account yet": see Prerequisites.
  • 403 on a write: the member lacks permission to update the project's lifecycle settings. Say so, and stop.

Out of scope

References

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts14d3 checks · Risk SAFE
  • Gen Agent Trust Hub14d

    The skill is safe. It defines a set of operations for managing LaunchDarkly auto-archival settings via an official Model Context Protocol (MCP) server. It includes robust internal safety guidelines, such as mandatory user confirmation for all modifications and a requirement for manual human intervention to enable archival features, which prevents the agent from making uncontrolled high-risk changes.

  • Socket14d

    No alerts

  • Snyk14d

    Risk: LOW · No issues

Signed by skilld at f0ee110. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 weeks ago
compatibility
Requires the remotely hosted LaunchDarkly MCP server
metadata
{
  "author": "launchdarkly",
  "version": "0.1.0-experimental"
}

README badge

README badge for launchdarkly/ai-tooling/launchdarkly-automations-archival-settings