agentleFS
itentialitential/infra-agent-skills/skills/cmdb-asset-management/SKILL.md

cmdb-asset-management

Skill1 starsChanged 32 days agoApache-2.0View on GitHub

Create, read, update, and delete Configuration Items (CIs) in a CMDB/asset-management platform, and read relationships between them — currently ServiceNow (Table API + CMDB Instance API, the latter routed through Identification and Reconciliation for deduplication) and iTop (REST/JSON services). Use when an agent needs to manage inventory/asset records themselves, distinct from change requests, tickets, or DNS/IPAM records that reference those assets. Assumes an authenticated client for the target platform's API is already available; this skill does not provision or authenticate it. Does not cover discovery/service-mapping configuration, CI class schema administration, or writing new relationship records.

The file

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Not for change requests (see change-management), DNS records (see dns-record-management), IP address allocation (see ipam-allocation), or a …

    line 17
  2. Distinctive:

    Does not cover discovery/service-mapping configuration, CI class schema administration, or writing new relationship records — only reading …

    line 58

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

CMDB / Asset Management

Manages Configuration Item (CI) records and their relationships on whichever CMDB/asset-management platform the caller is targeting, following that platform's own documented procedure — including any deduplication/identification mechanism the platform provides for writes.

When to use this skill

  • Creating, reading, updating, or deleting a CI (server, application, service, etc.) or reading the relationships between CIs, on a supported platform.
  • Not for change requests (see change-management), DNS records (see dns-record-management), IP address allocation (see ipam-allocation), or a physical asset's rack-unit/power placement (see dcim-asset-management) — those are adjacent records that may reference a CI by identifier (or represent the same physical device from a different angle), but managing them is out of scope here.

Universal concepts (shared CMDB vocabulary, not a wire standard)

  • A CI write and a CI's identity are not the same question. Some platforms (ServiceNow via IRE) route writes through an identification step that decides whether the payload matches an existing record before deciding to create a new one, while others simply create a new record on every create call — treat "the write succeeded" and "a new record was created" as two different facts to confirm, not one.
  • Where multiple sources feed the same platform, reconciliation rules (where they exist) decide which source wins on a contested field — a successful write doesn't guarantee the value sticks if a higher-priority source claims that field. Don't assume last-write-wins on a platform with a documented reconciliation mechanism.
  • A relationship is directional — always check both sides. "What does this CI depend on" and "what depends on this CI" are different queries; don't assume checking one direction covers both.
  • Deleting a CI is rarely gated by relationship checks at the platform level — confirming nothing currently depends on a CI before deleting it is this skill's own discipline in every platform procedure under this category, not something to assume the platform enforces automatically.

See references/INDEX.md for which platforms have a procedure, and each platform file for how it implements this shape concretely.

Procedure

  1. Identify the target platform — from the caller's request or the platform argument. Check references/INDEX.md; if no matching row exists, stop: this skill doesn't cover it yet.
  2. Open references/<platform>/procedure.md and follow it exactly — it contains that platform's full operational procedure, error handling, patterns, known limitations, tools, and verification checklist.
  3. Report the outcome using that platform procedure's own status vocabulary — including whether a write created a new record or matched/updated an existing one, where the platform makes that distinction.

Known limitations

  • Currently covers ServiceNow and iTop only — see references/INDEX.md. A platform not listed there needs a new reference file before this skill can be used for it.
  • Does not cover discovery/service-mapping configuration, CI class schema administration, or writing new relationship records — only reading existing relationships is covered where documented.

Contributing to this skill

SKILL.md only changes for two reasons: a bug in the universal concepts/router logic above, or adding a pointer to a newly-supported platform. Platform-specific procedure changes belong in that platform's own references/<platform>/procedure.md and endpoints.md, never here.

Tools

Each platform assumes its own authenticated client — see references/INDEX.md for which, and that platform's procedure.md for the specific operations.

Verification checklist

  • Target platform confirmed against references/INDEX.md before proceeding
  • That platform's own procedure.md was followed, including its own identification/reconciliation or equivalent deduplication behavior, and confirmation gates
  • Outcome reported using the platform procedure's own status vocabulary, distinguishing a new record from a matched/updated existing one where the platform makes that distinction

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.