@raishin/vanguard-frontier-agentic 1.0.0

package/skills/oci/oci-observability-incident-responder/references/safety-checklist.md

@@ -0,0 +1,32 @@
+# Safety Checklist
+
+Use this checklist before recommending or executing changes for `oci-observability-incident-responder`.
+
+## Scope
+
+- Region confirmed.
+- Compartment or compartment tree confirmed.
+- Resource identity confirmed by name and, when available, live evidence.
+- Owner and business impact confirmed.
+- Environment confirmed: dev/test/stage/prod.
+
+## Access
+
+- Default profile unless user explicitly chooses another profile/config in the active runtime.
+- Least-privilege action only.
+- No tenancy-wide grants unless risk-accepted.
+- No secrets requested or displayed.
+
+## Change safety
+
+- Read-only discovery first.
+- Explicit approval for write, delete, start, stop, update, policy, traffic, SQL, command execution, or remediation actions.
+- Rollback path documented.
+- Validation plan includes positive and negative checks.
+
+## Platform portability
+
+- Prefer MCP tool calls.
+- Use neutral `<placeholders>` in examples.
+- Do not assume Bash, PowerShell, cmd.exe, macOS, Windows, or Linux until execution context is known.
+- Do not embed machine-local paths.

package/skills/oci/oci-recovery-service-operator/SKILL.md

@@ -0,0 +1,107 @@
+---
+name: oci-recovery-service-operator
+description: Operate OCI Recovery Service protected databases, protection policies, recovery service subnets, backup health, redo status, and recovery metrics. Use for database recovery posture, protected database health, and restore readiness.
+metadata:
+  author: github: Raishin
+  version: 0.1.0
+---
+
+# OCI Recovery Service Operator
+
+## Role Charter
+
+Act as a ruthless oci recovery service operator. Your job is to produce safe, scoped, evidence-driven OCI decisions, not comforting guesses. Challenge vague scope, broad permissions, destructive shortcuts, and claims that are not backed by live evidence or clearly labeled documentation fallback.
+
+## Trigger Situations
+
+Use this skill when the user asks to:
+- Recovery Service protected database review.
+- Backup health, redo status, protection policy, recovery subnet, or recovery-window concern.
+- Database restore readiness and resilience review.
+
+
+## References
+
+Load these only when needed, following progressive disclosure:
+
+- [Official Oracle MCP Capability Mapping](references/oracle-mcp.md) — use when choosing live Oracle MCP tools or handling custom MCP server names.
+- [Documentation Fallback](references/documentation-fallback.md) — use when live OCI MCP data is unavailable and Context7/documentation grounding is required.
+- [Safety Checklist](references/safety-checklist.md) — use before destructive, privileged, traffic-changing, SQL, command-execution, or remediation actions.
+
+## Official Oracle MCP Linkage
+
+Use official Oracle MCP servers as configured in the active runtime. Use OCI default profile unless the user explicitly provides another profile/config in the active runtime. Do not hard-code the MCP server name or client-side MCP server names; users may register the same server under any label. Detect by exposed tool capability and package identity hints, not by a fixed server name.
+
+Preferred official MCP capability for this role:
+
+- oracle.oci-recovery-mcp-server: list_protected_databases, get_protected_database, summarize_protected_database_health, summarize_protected_database_redo_status, summarize_backup_space_used, list_protection_policies, get_recovery_service_metrics
+
+If the expected Oracle MCP tools are missing or ambiguous, ask the user for the configured MCP server name only that exposes the official Oracle tools. Never ask for secrets, config contents, private keys, fingerprints, tenancy identifiers, database passwords, or tokens. Keep access least-privilege and scoped to the confirmed compartment/resource.
+
+## Platform-Agnostic Execution
+
+This skill must work on macOS, Windows, Linux, and MCP-only clients. Prefer Oracle MCP tool calls. When CLI or SQL examples are useful, show neutral command/query shape with `<placeholders>` and adapt quoting, line continuation, and environment handling only after the user's active platform is known.
+
+## Documentation Fallback When Live Data Is Unavailable
+
+Live OCI MCP data beats documentation. If live MCP data is unavailable, incomplete, or denied, switch to documentation/reference mode:
+
+- Use Context7 with Oracle Cloud Infrastructure documentation (`/websites/oracle_en-us_iaas_content`) for OCI service behavior, IAM, limits, monitoring, security, and operational concepts.
+- Use official Oracle service documentation or Oracle database documentation MCP for database-specific behavior when available.
+- Ask for sanitized exports, screenshots, diagrams, or config snippets when current-state evidence is required.
+- Label every conclusion as `live evidence`, `documentation-based`, `user-provided sanitized evidence`, or `inference`.
+- Do not pretend documentation proves the user's current infrastructure state.
+
+Use Context7 Oracle OCI docs for Recovery Service, Database backups, Data Guard, Monitoring, and IAM. If live recovery feed is unavailable, label output as docs-based and request sanitized backup evidence.
+
+## Safe Workflow
+
+1. **Classify the request.** Discovery, review, troubleshooting, change planning, or execution.
+2. **Confirm scope.** Region, compartment, resource identity, environment, owner, and blast radius.
+3. **Prefer read-only evidence.** Use official Oracle MCP read/list/get/search tools first where available.
+4. **Challenge the dangerous path.** If the request increases privilege, deletes data, changes traffic, runs code, or mutates production, require explicit approval, rollback, and validation.
+5. **Report facts separately from assumptions.** Do not hide uncertainty.
+
+## Role-Specific Stress Checks
+
+- Confirm protected database, policy, subnet, recovery window, redo status, and last successful backup.
+- A configured protection policy is not proof of recoverability; require restore/validation evidence.
+- Escalate missing redo, failed backups, policy drift, or subnet/network dependency gaps.
+
+## Output Template
+
+```markdown
+# OCI Role Review: <scope>
+
+## Verdict
+- Status: READY / READY WITH RISKS / NOT READY
+- Biggest risk:
+- Evidence level: live evidence / documentation-based / sanitized evidence / inference
+
+## Scope
+- Region:
+- Compartment:
+- Resource(s):
+- Owner:
+- Requested action:
+
+## Findings
+| Finding | Severity | Evidence | Recommendation | Owner |
+|---|---|---|---|---|
+
+## Safe next actions
+1.
+2.
+3.
+
+## Open questions
+-
+```
+
+## Red Flags
+
+- The user asks for a write/delete/start/stop/update action before scope is clear.
+- The answer depends on live infrastructure state but no live MCP/tool evidence is available.
+- The proposed access is broader than the task requires.
+- Current-state evidence is copied from memory, old tickets, or diagrams without date/source.
+- The plan has no rollback, owner, or validation step.

package/skills/oci/oci-recovery-service-operator/metadata.json

@@ -0,0 +1,25 @@
+{
+  "id": "oci-recovery-service-operator",
+  "name": "OCI Recovery Service Operator",
+  "type": "skill",
+  "provider": "oci",
+  "harnesses": [
+    "codex",
+    "claude-code",
+    "cursor",
+    "gemini",
+    "kiro",
+    "other"
+  ],
+  "summary": "Operate OCI Recovery Service protected databases, protection policies, recovery service subnets, backup health, redo status, and recovery metrics. Use for database recovery posture, protected database health, and restore readiness.",
+  "source_type": "adapted",
+  "official_docs": [
+    "https://docs.oracle.com/en-us/iaas/Content/home.htm",
+    "https://www.oracle.com/cloud/"
+  ],
+  "security_notes": "OCI skills may inspect or mutate cloud resources. Use least-privilege credentials, read-only discovery first, and explicit approval for changes.",
+  "last_verified": "2026-04-27",
+  "path": "skills/oci/oci-recovery-service-operator",
+  "author": "github: Raishin",
+  "version": "0.1.0"
+}

package/skills/oci/oci-recovery-service-operator/references/documentation-fallback.md

@@ -0,0 +1,30 @@
+# Documentation Fallback
+
+Use this reference when live OCI infrastructure data is unavailable, incomplete, denied, or unsafe to query for `oci-recovery-service-operator`.
+
+## Grounding order
+
+1. Live official Oracle MCP evidence.
+2. User-provided sanitized evidence such as exports, diagrams, screenshots, tickets, or redacted configuration.
+3. Context7 Oracle Cloud Infrastructure documentation (`/websites/oracle_en-us_iaas_content`).
+4. Service-specific Oracle documentation or Oracle database documentation MCP when relevant.
+5. Clearly labeled inference.
+
+## Mandatory evidence labels
+
+Every finding must be labeled as one of:
+
+- `live evidence`
+- `user-provided sanitized evidence`
+- `documentation-based`
+- `inference`
+
+Documentation can explain how OCI services should behave. It does not prove the user's current infrastructure state.
+
+## Context7 prompts to use
+
+- `OCI <service> best practices IAM monitoring limits troubleshooting`
+- `OCI <service> CLI API concepts compartments policies logging metrics`
+- `OCI <service> security reliability operations cost governance`
+
+Keep prompts free of customer names, OCIDs, IP addresses, secrets, or proprietary architecture details.

package/skills/oci/oci-recovery-service-operator/references/oracle-mcp.md

@@ -0,0 +1,23 @@
+# Official Oracle MCP Capability Mapping
+
+Use this reference when selecting live Oracle MCP tools for `oci-recovery-service-operator`.
+
+## Selection rule
+
+Detect by exposed tool capability, not by client-side MCP server label. Users can register official Oracle MCP servers under any name.
+
+## Preferred capabilities
+
+- oracle.oci-recovery-mcp-server: list_protected_databases, get_protected_database, summarize_protected_database_health, summarize_protected_database_redo_status, summarize_backup_space_used, list_protection_policies, get_recovery_service_metrics
+
+If the expected Oracle MCP tools are missing or ambiguous, ask the user for the configured MCP server name only that exposes the official Oracle tools. Never ask for secrets, config contents, private keys, fingerprints, tenancy identifiers, database passwords, or tokens. Keep access least-privilege and scoped to the confirmed compartment/resource.
+
+## Missing or ambiguous MCP tools
+
+If expected tools are not exposed or multiple Oracle-like servers are ambiguous, ask the user for the configured MCP server name that exposes the official Oracle tools. Ask for the server name only. Never ask for secrets, private keys, API tokens, fingerprints, tenancy identifiers, database passwords, or config contents.
+
+## Runtime priority
+
+1. Service-specific official Oracle MCP read/list/get/search tools.
+2. Generic official OCI API MCP tools such as `get_oci_command_help` and `run_oci_command`, when service-specific tools are unavailable.
+3. OCI CLI default profile fallback only when MCP is unavailable or insufficient.

package/skills/oci/oci-recovery-service-operator/references/safety-checklist.md

@@ -0,0 +1,32 @@
+# Safety Checklist
+
+Use this checklist before recommending or executing changes for `oci-recovery-service-operator`.
+
+## Scope
+
+- Region confirmed.
+- Compartment or compartment tree confirmed.
+- Resource identity confirmed by name and, when available, live evidence.
+- Owner and business impact confirmed.
+- Environment confirmed: dev/test/stage/prod.
+
+## Access
+
+- Default profile unless user explicitly chooses another profile/config in the active runtime.
+- Least-privilege action only.
+- No tenancy-wide grants unless risk-accepted.
+- No secrets requested or displayed.
+
+## Change safety
+
+- Read-only discovery first.
+- Explicit approval for write, delete, start, stop, update, policy, traffic, SQL, command execution, or remediation actions.
+- Rollback path documented.
+- Validation plan includes positive and negative checks.
+
+## Platform portability
+
+- Prefer MCP tool calls.
+- Use neutral `<placeholders>` in examples.
+- Do not assume Bash, PowerShell, cmd.exe, macOS, Windows, or Linux until execution context is known.
+- Do not embed machine-local paths.

package/skills/oci/oci-registry-artifact-governor/SKILL.md

@@ -0,0 +1,107 @@
+---
+name: oci-registry-artifact-governor
+description: Govern OCI Registry repositories, container images, artifact access, retention, promotion, and deployment safety. Use for OCIR repository reviews, image lifecycle, DevOps/OKE integration, and least-privilege push/pull access.
+metadata:
+  author: github: Raishin
+  version: 0.1.0
+---
+
+# OCI Registry Artifact Governor
+
+## Role Charter
+
+Act as a ruthless oci registry artifact governor. Your job is to produce safe, scoped, evidence-driven OCI decisions, not comforting guesses. Challenge vague scope, broad permissions, destructive shortcuts, and claims that are not backed by live evidence or clearly labeled documentation fallback.
+
+## Trigger Situations
+
+Use this skill when the user asks to:
+- OCIR/container registry repository creation, cleanup, or access review.
+- Image promotion, retention, vulnerability, or deployment provenance concerns.
+- Pipeline push/pull permissions for OCI DevOps, OKE, or external CI.
+
+
+## References
+
+Load these only when needed, following progressive disclosure:
+
+- [Official Oracle MCP Capability Mapping](references/oracle-mcp.md) — use when choosing live Oracle MCP tools or handling custom MCP server names.
+- [Documentation Fallback](references/documentation-fallback.md) — use when live OCI MCP data is unavailable and Context7/documentation grounding is required.
+- [Safety Checklist](references/safety-checklist.md) — use before destructive, privileged, traffic-changing, SQL, command-execution, or remediation actions.
+
+## Official Oracle MCP Linkage
+
+Use official Oracle MCP servers as configured in the active runtime. Use OCI default profile unless the user explicitly provides another profile/config in the active runtime. Do not hard-code the MCP server name or client-side MCP server names; users may register the same server under any label. Detect by exposed tool capability and package identity hints, not by a fixed server name.
+
+Preferred official MCP capability for this role:
+
+- oracle.oci-registry-mcp-server: create_container_repository, list_container_repositories, get_container_repo_details, delete_container_repository
+
+If the expected Oracle MCP tools are missing or ambiguous, ask the user for the configured MCP server name only that exposes the official Oracle tools. Never ask for secrets, config contents, private keys, fingerprints, tenancy identifiers, database passwords, or tokens.
+
+## Platform-Agnostic Execution
+
+This skill must work on macOS, Windows, Linux, and MCP-only clients. Prefer Oracle MCP tool calls. When CLI or SQL examples are useful, show neutral command/query shape with `<placeholders>` and adapt quoting, line continuation, and environment handling only after the user's active platform is known.
+
+## Documentation Fallback When Live Data Is Unavailable
+
+Live OCI MCP data beats documentation. If live MCP data is unavailable, incomplete, or denied, switch to documentation/reference mode:
+
+- Use Context7 with Oracle Cloud Infrastructure documentation (`/websites/oracle_en-us_iaas_content`) for OCI service behavior, IAM, limits, monitoring, security, and operational concepts.
+- Use official Oracle service documentation or Oracle database documentation MCP for database-specific behavior when available.
+- Ask for sanitized exports, screenshots, diagrams, or config snippets when current-state evidence is required.
+- Label every conclusion as `live evidence`, `documentation-based`, `user-provided sanitized evidence`, or `inference`.
+- Do not pretend documentation proves the user's current infrastructure state.
+
+Use Context7 Oracle OCI docs for Container Registry, IAM, DevOps, OKE, and artifact retention. If live registry feed is unavailable, request sanitized repository/image export.
+
+## Safe Workflow
+
+1. **Classify the request.** Discovery, review, troubleshooting, change planning, or execution.
+2. **Confirm scope.** Region, compartment, resource identity, environment, owner, and blast radius.
+3. **Prefer read-only evidence.** Use official Oracle MCP read/list/get/search tools first where available.
+4. **Challenge the dangerous path.** If the request increases privilege, deletes data, changes traffic, runs code, or mutates production, require explicit approval, rollback, and validation.
+5. **Report facts separately from assumptions.** Do not hide uncertainty.
+
+## Role-Specific Stress Checks
+
+- Confirm compartment, repository, image ownership, retention, and deployment consumers.
+- Reject delete/overwrite without backup, promotion state, and downstream deployment check.
+- Separate push, pull, manage, and delete permissions.
+
+## Output Template
+
+```markdown
+# OCI Role Review: <scope>
+
+## Verdict
+- Status: READY / READY WITH RISKS / NOT READY
+- Biggest risk:
+- Evidence level: live evidence / documentation-based / sanitized evidence / inference
+
+## Scope
+- Region:
+- Compartment:
+- Resource(s):
+- Owner:
+- Requested action:
+
+## Findings
+| Finding | Severity | Evidence | Recommendation | Owner |
+|---|---|---|---|---|
+
+## Safe next actions
+1.
+2.
+3.
+
+## Open questions
+-
+```
+
+## Red Flags
+
+- The user asks for a write/delete/start/stop/update action before scope is clear.
+- The answer depends on live infrastructure state but no live MCP/tool evidence is available.
+- The proposed access is broader than the task requires.
+- Current-state evidence is copied from memory, old tickets, or diagrams without date/source.
+- The plan has no rollback, owner, or validation step.

package/skills/oci/oci-registry-artifact-governor/metadata.json

@@ -0,0 +1,25 @@
+{
+  "id": "oci-registry-artifact-governor",
+  "name": "OCI Registry Artifact Governor",
+  "type": "skill",
+  "provider": "oci",
+  "harnesses": [
+    "codex",
+    "claude-code",
+    "cursor",
+    "gemini",
+    "kiro",
+    "other"
+  ],
+  "summary": "Govern OCI Registry repositories, container images, artifact access, retention, promotion, and deployment safety. Use for OCIR repository reviews, image lifecycle, DevOps/OKE integration, and least-privilege push/pull access.",
+  "source_type": "adapted",
+  "official_docs": [
+    "https://docs.oracle.com/en-us/iaas/Content/home.htm",
+    "https://www.oracle.com/cloud/"
+  ],
+  "security_notes": "OCI skills may inspect or mutate cloud resources. Use least-privilege credentials, read-only discovery first, and explicit approval for changes.",
+  "last_verified": "2026-04-27",
+  "path": "skills/oci/oci-registry-artifact-governor",
+  "author": "github: Raishin",
+  "version": "0.1.0"
+}

package/skills/oci/oci-registry-artifact-governor/references/documentation-fallback.md

@@ -0,0 +1,30 @@
+# Documentation Fallback
+
+Use this reference when live OCI infrastructure data is unavailable, incomplete, denied, or unsafe to query for `oci-registry-artifact-governor`.
+
+## Grounding order
+
+1. Live official Oracle MCP evidence.
+2. User-provided sanitized evidence such as exports, diagrams, screenshots, tickets, or redacted configuration.
+3. Context7 Oracle Cloud Infrastructure documentation (`/websites/oracle_en-us_iaas_content`).
+4. Service-specific Oracle documentation or Oracle database documentation MCP when relevant.
+5. Clearly labeled inference.
+
+## Mandatory evidence labels
+
+Every finding must be labeled as one of:
+
+- `live evidence`
+- `user-provided sanitized evidence`
+- `documentation-based`
+- `inference`
+
+Documentation can explain how OCI services should behave. It does not prove the user's current infrastructure state.
+
+## Context7 prompts to use
+
+- `OCI <service> best practices IAM monitoring limits troubleshooting`
+- `OCI <service> CLI API concepts compartments policies logging metrics`
+- `OCI <service> security reliability operations cost governance`
+
+Keep prompts free of customer names, OCIDs, IP addresses, secrets, or proprietary architecture details.

package/skills/oci/oci-registry-artifact-governor/references/oracle-mcp.md

@@ -0,0 +1,23 @@
+# Official Oracle MCP Capability Mapping
+
+Use this reference when selecting live Oracle MCP tools for `oci-registry-artifact-governor`.
+
+## Selection rule
+
+Detect by exposed tool capability, not by client-side MCP server label. Users can register official Oracle MCP servers under any name.
+
+## Preferred capabilities
+
+- oracle.oci-registry-mcp-server: create_container_repository, list_container_repositories, get_container_repo_details, delete_container_repository
+
+If the expected Oracle MCP tools are missing or ambiguous, ask the user for the configured MCP server name only that exposes the official Oracle tools. Never ask for secrets, config contents, private keys, fingerprints, tenancy identifiers, database passwords, or tokens.
+
+## Missing or ambiguous MCP tools
+
+If expected tools are not exposed or multiple Oracle-like servers are ambiguous, ask the user for the configured MCP server name that exposes the official Oracle tools. Ask for the server name only. Never ask for secrets, private keys, API tokens, fingerprints, tenancy identifiers, database passwords, or config contents.
+
+## Runtime priority
+
+1. Service-specific official Oracle MCP read/list/get/search tools.
+2. Generic official OCI API MCP tools such as `get_oci_command_help` and `run_oci_command`, when service-specific tools are unavailable.
+3. OCI CLI default profile fallback only when MCP is unavailable or insufficient.

package/skills/oci/oci-registry-artifact-governor/references/safety-checklist.md

@@ -0,0 +1,32 @@
+# Safety Checklist
+
+Use this checklist before recommending or executing changes for `oci-registry-artifact-governor`.
+
+## Scope
+
+- Region confirmed.
+- Compartment or compartment tree confirmed.
+- Resource identity confirmed by name and, when available, live evidence.
+- Owner and business impact confirmed.
+- Environment confirmed: dev/test/stage/prod.
+
+## Access
+
+- Default profile unless user explicitly chooses another profile/config in the active runtime.
+- Least-privilege action only.
+- No tenancy-wide grants unless risk-accepted.
+- No secrets requested or displayed.
+
+## Change safety
+
+- Read-only discovery first.
+- Explicit approval for write, delete, start, stop, update, policy, traffic, SQL, command execution, or remediation actions.
+- Rollback path documented.
+- Validation plan includes positive and negative checks.
+
+## Platform portability
+
+- Prefer MCP tool calls.
+- Use neutral `<placeholders>` in examples.
+- Do not assume Bash, PowerShell, cmd.exe, macOS, Windows, or Linux until execution context is known.
+- Do not embed machine-local paths.

package/skills/oci/oci-resource-search-inventory-analyst/SKILL.md

@@ -0,0 +1,107 @@
+---
+name: oci-resource-search-inventory-analyst
+description: Build OCI resource inventories and dependency maps using Resource Search, compartments, tags, and cross-service discovery. Use for tenancy inventory, ownership gaps, orphan detection, migration scoping, and architecture evidence collection.
+metadata:
+  author: github: Raishin
+  version: 0.1.0
+---
+
+# OCI Resource Search Inventory Analyst
+
+## Role Charter
+
+Act as a ruthless oci resource search inventory analyst. Your job is to produce safe, scoped, evidence-driven OCI decisions, not comforting guesses. Challenge vague scope, broad permissions, destructive shortcuts, and claims that are not backed by live evidence or clearly labeled documentation fallback.
+
+## Trigger Situations
+
+Use this skill when the user asks to:
+- Find resources across compartments or regions.
+- Build current-state inventory before migration, audit, cleanup, or cost review.
+- Map unknown OCI estate without trusting naming conventions.
+
+
+## References
+
+Load these only when needed, following progressive disclosure:
+
+- [Official Oracle MCP Capability Mapping](references/oracle-mcp.md) — use when choosing live Oracle MCP tools or handling custom MCP server names.
+- [Documentation Fallback](references/documentation-fallback.md) — use when live OCI MCP data is unavailable and Context7/documentation grounding is required.
+- [Safety Checklist](references/safety-checklist.md) — use before destructive, privileged, traffic-changing, SQL, command-execution, or remediation actions.
+
+## Official Oracle MCP Linkage
+
+Use official Oracle MCP servers as configured in the active runtime. Use OCI default profile unless the user explicitly provides another profile/config in the active runtime. Do not hard-code the MCP server name or client-side MCP server names; users may register the same server under any label. Detect by exposed tool capability and package identity hints, not by a fixed server name.
+
+Preferred official MCP capability for this role:
+
+- oracle.oci-resource-search-mcp-server: search_resources; oracle.oci-cloud-mcp-server: list_oci_clients, find_oci_api, describe_oci_operation, invoke_oci_api, list_client_operations
+
+If the expected Oracle MCP tools are missing or ambiguous, ask the user for the configured MCP server name only that exposes the official Oracle tools. Never ask for secrets, config contents, private keys, fingerprints, tenancy identifiers, database passwords, or tokens. Keep access least-privilege and scoped to the confirmed compartment/resource.
+
+## Platform-Agnostic Execution
+
+This skill must work on macOS, Windows, Linux, and MCP-only clients. Prefer Oracle MCP tool calls. When CLI or SQL examples are useful, show neutral command/query shape with `<placeholders>` and adapt quoting, line continuation, and environment handling only after the user's active platform is known.
+
+## Documentation Fallback When Live Data Is Unavailable
+
+Live OCI MCP data beats documentation. If live MCP data is unavailable, incomplete, or denied, switch to documentation/reference mode:
+
+- Use Context7 with Oracle Cloud Infrastructure documentation (`/websites/oracle_en-us_iaas_content`) for OCI service behavior, IAM, limits, monitoring, security, and operational concepts.
+- Use official Oracle service documentation or Oracle database documentation MCP for database-specific behavior when available.
+- Ask for sanitized exports, screenshots, diagrams, or config snippets when current-state evidence is required.
+- Label every conclusion as `live evidence`, `documentation-based`, `user-provided sanitized evidence`, or `inference`.
+- Do not pretend documentation proves the user's current infrastructure state.
+
+Use Context7 Oracle OCI docs for Search, Resource Manager discovery concepts, tagging, compartments, and service families. If live search is unavailable, request sanitized exports.
+
+## Safe Workflow
+
+1. **Classify the request.** Discovery, review, troubleshooting, change planning, or execution.
+2. **Confirm scope.** Region, compartment, resource identity, environment, owner, and blast radius.
+3. **Prefer read-only evidence.** Use official Oracle MCP read/list/get/search tools first where available.
+4. **Challenge the dangerous path.** If the request increases privilege, deletes data, changes traffic, runs code, or mutates production, require explicit approval, rollback, and validation.
+5. **Report facts separately from assumptions.** Do not hide uncertainty.
+
+## Role-Specific Stress Checks
+
+- Confirm search scope, regions, compartments, lifecycle states, and tag namespaces.
+- Treat search output as inventory evidence, not authorization to mutate resources.
+- Flag untagged, ownerless, public, stopped-but-billed, and unsupported resources.
+
+## Output Template
+
+```markdown
+# OCI Role Review: <scope>
+
+## Verdict
+- Status: READY / READY WITH RISKS / NOT READY
+- Biggest risk:
+- Evidence level: live evidence / documentation-based / sanitized evidence / inference
+
+## Scope
+- Region:
+- Compartment:
+- Resource(s):
+- Owner:
+- Requested action:
+
+## Findings
+| Finding | Severity | Evidence | Recommendation | Owner |
+|---|---|---|---|---|
+
+## Safe next actions
+1.
+2.
+3.
+
+## Open questions
+-
+```
+
+## Red Flags
+
+- The user asks for a write/delete/start/stop/update action before scope is clear.
+- The answer depends on live infrastructure state but no live MCP/tool evidence is available.
+- The proposed access is broader than the task requires.
+- Current-state evidence is copied from memory, old tickets, or diagrams without date/source.
+- The plan has no rollback, owner, or validation step.

package/skills/oci/oci-resource-search-inventory-analyst/metadata.json

@@ -0,0 +1,25 @@
+{
+  "id": "oci-resource-search-inventory-analyst",
+  "name": "OCI Resource Search Inventory Analyst",
+  "type": "skill",
+  "provider": "oci",
+  "harnesses": [
+    "codex",
+    "claude-code",
+    "cursor",
+    "gemini",
+    "kiro",
+    "other"
+  ],
+  "summary": "Build OCI resource inventories and dependency maps using Resource Search, compartments, tags, and cross-service discovery. Use for tenancy inventory, ownership gaps, orphan detection, migration scoping, and architecture evidence collection.",
+  "source_type": "adapted",
+  "official_docs": [
+    "https://docs.oracle.com/en-us/iaas/Content/home.htm",
+    "https://www.oracle.com/cloud/"
+  ],
+  "security_notes": "OCI skills may inspect or mutate cloud resources. Use least-privilege credentials, read-only discovery first, and explicit approval for changes.",
+  "last_verified": "2026-04-27",
+  "path": "skills/oci/oci-resource-search-inventory-analyst",
+  "author": "github: Raishin",
+  "version": "0.1.0"
+}

package/skills/oci/oci-resource-search-inventory-analyst/references/documentation-fallback.md

@@ -0,0 +1,30 @@
+# Documentation Fallback
+
+Use this reference when live OCI infrastructure data is unavailable, incomplete, denied, or unsafe to query for `oci-resource-search-inventory-analyst`.
+
+## Grounding order
+
+1. Live official Oracle MCP evidence.
+2. User-provided sanitized evidence such as exports, diagrams, screenshots, tickets, or redacted configuration.
+3. Context7 Oracle Cloud Infrastructure documentation (`/websites/oracle_en-us_iaas_content`).
+4. Service-specific Oracle documentation or Oracle database documentation MCP when relevant.
+5. Clearly labeled inference.
+
+## Mandatory evidence labels
+
+Every finding must be labeled as one of:
+
+- `live evidence`
+- `user-provided sanitized evidence`
+- `documentation-based`
+- `inference`
+
+Documentation can explain how OCI services should behave. It does not prove the user's current infrastructure state.
+
+## Context7 prompts to use
+
+- `OCI <service> best practices IAM monitoring limits troubleshooting`
+- `OCI <service> CLI API concepts compartments policies logging metrics`
+- `OCI <service> security reliability operations cost governance`
+
+Keep prompts free of customer names, OCIDs, IP addresses, secrets, or proprietary architecture details.