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.
In this repository40 other files it gives its agents.
- AGENTS.mdAGENTS.md
- alert-monitor-managementSkill
- automation-job-executionSkill
- casb-policy-managementSkill
- casb-posture-assessmentSkill
- certificate-managementSkill
- change-managementSkill
- cloud-security-group-auditSkill
- compute-instance-provisioningSkill
- config-backup-managementSkill
- connector-tunnel-managementSkill
- container-workload-deploymentSkill
- crm-contact-managementSkill
- dcim-asset-managementSkill
- dhcp-scope-managementSkill
- dns-record-managementSkill
- dns-zone-managementSkill
- firewall-managementSkill
- incident-managementSkill
- infrastructure-plan-executionSkill
- interface-link-troubleshootingSkill
- ipam-allocationSkill
- load-balancingSkill
- log-querySkill
- metric-querySkill
- network-access-control-managementSkill
- network-health-verificationSkill
- network-state-collectionSkill
- notificationsSkill
- repository-pull-request-managementSkill
- routing-troubleshootingSkill
- sdwan-policy-managementSkill
- sdwan-site-onboardingSkill
- secret-retrievalSkill
- software-upgrade-lifecycleSkill
- vpn-tunnel-managementSkill
- vulnerability-lookupSkill
- waf-managementSkill
- wireless-network-managementSkill
- zero-trust-access-policy-managementSkill
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
- Very specific: line 17
Not for change requests (see change-management), DNS records (see dns-record-management), IP address allocation (see ipam-allocation), or a …
- Distinctive: line 58
Does not cover discovery/service-mapping configuration, CI class schema administration, or writing new relationship records — only reading …
≈ “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.
Files
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 (seedns-record-management), IP address allocation (seeipam-allocation), or a physical asset's rack-unit/power placement (seedcim-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
- Identify the target platform — from the caller's request or the
platformargument. Checkreferences/INDEX.md; if no matching row exists, stop: this skill doesn't cover it yet. - Open
references/<platform>/procedure.mdand follow it exactly — it contains that platform's full operational procedure, error handling, patterns, known limitations, tools, and verification checklist. - 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.mdbefore proceeding - That platform's own
procedure.mdwas 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
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
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.

