Skip to content
Skills Library
DevOps & cloud · Review & audit

appinterface-check

/appinterface-check

Validate app-interface configuration and release readiness. Validates YAML, compares refs to live cluster, shows quotas, pending MRs. Use when user says "check app-interface", "app-interface validation".

Repository
skills ↗
Licence
Apache-2.0
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Validate app-interface configuration and release readiness. Validates YAML, compares refs to live cluster, shows quotas, pending MRs. Use when user says "check app-interface", "app-interface validation".

Triggers from the description

check app-interfaceapp-interface validation
Original author description

Validate app-interface configuration and release readiness. Validates YAML, compares refs to live cluster, shows quotas, pending MRs. Use when user says "check app-interface", "app-interface validation".

How it works

  1. Inputs
  2. Workflow
  3. Key MCP Tools
  4. Key Namespaces
  5. If Ready to Release
Original SKILL.md headings · 91 lines, 410 words
SKILL.md preview
---
name: appinterface-check
description: Validate app-interface configuration and release readiness. Validates YAML, compares refs to live cluster, shows quotas, pending MRs. Use when user says "check app-interface", "app-interface validation".
---

# App-Interface Check

## Inputs

| Input | Type | Default | Purpose |
|-------|------|---------|---------|
| `saas_file` | string | tower-analytics | SaaS file name |
| `namespace_stage` | string | tower-analytics-stage | Stage namespace |
| `namespace_prod` | string | tower-analytics-prod | Production namespace |
| `deployment` | string | automation-analytics-api-fastapi-v2 | Deployment to check for live SHA |
| `stale_days` | int | 7 | Alert if deployed SHA older than this |
| `gitlab_project` | string | automation-analytics/automation-analytics-backend | Project for pending MRs |
| `app_name` | string | automation-analytics | Application name for search |

## Workflow

### 1. Bootstrap
- `persona_load("release")` — appinterface tools
- `check_known_issues("appinterface", "")`, `check_known_issues("release", "")`
- `knowledge_query(project="automation-analytics-backend", persona="release", section="gotchas")`

### 2. Get SaaS File
- `appinterface_search(query="{app_name}")`
- `appinterface_get_saas(service_name="{saas_file}")`
- Parse refs: stage_ref, prod_ref (40-char SHAs), $ref paths

### 3. Validation
- Validate SHA format: 40-char hex or 'main'
- Check $ref paths point to /services/ or /dependencies/
- Check required fields: name, app, resourceTemplates

### 4. Live State (switch to devops)
- `persona_load("devops")`
- `kubectl_get_deployments(namespace="{namespace_stage}", environment="stage")` — extract deployed image SHA
- `kubectl_get_deployments(namespace="{namespace_prod}", environment="prod")` — prod SHA

### 5. Compare State
- stage_in_sync = app-interface stage_ref matches live cluster
- prod_in_sync = app-interface prod_ref matches live cluster
- stage_ahead_of_prod = stage has newer ref
- ready_to_promote = stage_ahead and stage_in_sync

### 6. Diff & Resources
- `appinterface_diff()` — uncommitted changes
- `appinterface_resources(namespace="{namespace_stage}")`
- `kubectl_get(resource="resourcequota", namespace="{namespace_stage}", environment="stage")`
- `kubectl_get(resource="limitrange", namespace="{namespace_stage}", environment="stage")`

### 7. Pending MRs (switch to developer)
- `persona_load("developer")`
- `gitlab_mr_list(project="{gitlab_project}", state="opened", per_page=10)`

### 8. Release Readiness
- ready = validation_ok and stage_ahead and no_pending_changes
- blockers: validation issues, stage not ahead, uncommitted changes
- warnings: open MRs, stage drift

### 9. Report
- Validation status
- Live state comparison (stage vs prod)
- Pending changes
- Resource quotas/limits
- Pending MRs
- Release readiness
- Log: `memory_session_log("Checked app-interface", "Ready: {ready}")`

### 10. Failure Learning
- Not found → `learn_tool_fix("appinterface_get_saas", "not found", "SaaS file missing", "Check saas_file input")`
- Forbidden → `learn_tool_fix("kubectl_get_deployments", "forbidden", "K8s auth expired", "Run kube_login('stage') and kube_login('prod')")`
- No route to host → `learn_tool_fix("kubectl_get_deployments", "no route to host", "VPN not connected", "Run vpn_connect()")`
- No such host → `learn_tool_fix("gitlab_mr_list", "no such host", "VPN not connected", "Run vpn_connect()")`

## Key MCP Tools

- `persona_load`, `appinterface_search`, `appinterface_get_saas`, `appinterface_diff`, `appinterface_resources`
- `kubectl_get_deployments`, `kubectl_get`
- `gitlab_mr_list`
- `check_known_issues`, `learn_tool_fix`, `knowledge_query`, `memory_session_log`

## Key Namespaces

- **tower-analytics-stage** — stage
- **tower-analytics-prod** — production

## If Ready to Release

```python
skill_run("release_to_prod", '{"commit_sha": "{stage_ref}"}')
```

Versions

The database has no other skills named appinterface-check.

Database snapshot: 13.11.2026 · package version 5cbde27b5e4d (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100workspace-validator
    Validate an existing SAP workspace configuration before running tests — checks sap-parameters.yaml, hosts.yaml, and SSH auth readiness. Use when asked to validate or troubleshoot a workspace that already exists; not for creating a new one from scratch (see workspace-creator) and…
  • 90release-to-prod
    Create a Konflux release to push images from staging to production. Verifies image exists, runs security scan, validates app-interface, creates release. Use when user says "release to prod", "promote to production".
  • 100release
    Prepare local Render or Vercel deployment configuration and verify build, start, output, environment, and health-check readiness without deploying. Use for /release, Render setup, Vercel setup, deploy readiness, render.yaml, or vercel.json.
  • 100release
    Get finished work out to the world. Use when someone says "release it", "ship it", "publish it", "merge it", "deploy it", "put it live", "send it to the app store", "cut a release", or "the pull requests are green, take them live".
  • 90azure-validate
    **CRITICAL**: Run azure-validate before deploying Azure resources. Validates Azure deployment readiness. USE FOR: assess if application is ready to deploy to Azure, validate azure.yaml or Bicep configuration files, run Azure preflight checks, review deployment previews and…
  • 100rabbitmq-configuration-validation
    Validates RabbitMQ queue durability, mirroring/quorum configuration, and resource limits before production use. Use when the user asks to "review a RabbitMQ queue config before deploying," "check queue durability settings," "validate quorum/mirroring config," "audit RabbitMQ for…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.