# Mobile Builder

> A Claude skill from srinidhis05/agentura.

- **Type:** Skill
- **Install:** `agentstack add skill-srinidhis05-agentura-mobile-builder`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [srinidhis05](https://agentstack.voostack.com/s/srinidhis05)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [srinidhis05](https://github.com/srinidhis05)
- **Source:** https://github.com/srinidhis05/agentura/tree/main/skills/incubator/mobile-builder
- **Website:** https://agenturaai.tech

## Install

```sh
agentstack add skill-srinidhis05-agentura-mobile-builder
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Mobile Builder Agent

## MANDATORY EXECUTION RULE

**NEVER produce a text-only response.** Every single response you give MUST include at least one tool call (Bash, Write, Read, Edit, or Glob). If you want to explain what you're doing, include the explanation AND a tool call in the same response. A response with only text and no tool call will TERMINATE your execution immediately and the task will FAIL. This is a hard constraint of the runtime — not a suggestion.

Your execution is ONLY successful when you have written `TASK_RESULT.json` containing a valid `pr_url`. Any execution that ends without this file is a FAILURE.

## Task

Create a new feature module in the **mobile-app** Kotlin/Compose app from a structured spec. Clone → read harness → create code → build → push → PR → report. All in one continuous flow.

## Input Format

```json
{
  "feature_name": "expense-tracker",
  "pit_name": "expense_tracker",
  "pit_name_hyphenated": "expense-tracker",
  "mobile_spec": {
    "feature_package": "expense_tracker",
    "feature_flag_key": "feature_expense_tracker_enabled",
    "screens": [...],
    "navigation": {...},
    "data_layer": {
      "api_endpoints": [...],
      "models": [...]
    }
  },
  "feedback": "(optional) PM feedback for refinement",
  "frontend_branch": "(optional) existing branch name for refinement"
}
```

## Execution — One Continuous Flow

Do ALL of the following in order. Do NOT stop between steps. Do NOT summarize between steps. After each step, immediately proceed to the next step's tool calls.

### Step 1: Clone and branch

```bash
git clone https://x-access-token:${GITHUB_TOKEN}@github.com/your-org/mobile-app.git /tmp/mobile-app
cd /tmp/mobile-app
```

If `frontend_branch` is provided: `git checkout `
Otherwise: `git checkout -b feat/pit-`

### Step 2: Read the harness (max 7 files)

Read these — they tell you HOW to build:
1. `CLAUDE.md`
2. `DECISIONS.md` (if exists)
3. `GUARDRAILS.md` (if exists)
4. `.claude/skills/compose-ui/SKILL.md`
5. `.claude/skills/compose-navigation/SKILL.md`
6. `.claude/skills/android-architecture/SKILL.md`
7. `.claude/skills/android-data-layer/SKILL.md`

### Step 3: Create data layer

Under `data-layer/src/main/java/com/example/app/data_layer/network//`:
1. API Service — Retrofit interface from `mobile_spec.data_layer.api_endpoints`
2. Request/Response models — Kotlin data classes from `mobile_spec.data_layer.models`
3. Repository — wrapping the API service

Follow `.claude/skills/android-data-layer/SKILL.md` patterns exactly.

### Step 4: Create UI layer

Under `app/src/main/java/com/example/app/ui//`:
1. Screens — `@Composable` functions from `mobile_spec.screens`
2. ViewModels — `@HiltViewModel` with `StateFlow`
3. Navigation — nav graph from `mobile_spec.navigation`
4. Incubation banner on every screen:

```kotlin
@Composable
fun IncubationBanner(featureName: String) {
    Surface(
        color = MaterialTheme.colorScheme.tertiaryContainer,
        shape = RoundedCornerShape(8.dp),
        modifier = Modifier.fillMaxWidth().padding(16.dp)
    ) {
        Row(
            modifier = Modifier.padding(12.dp),
            verticalAlignment = Alignment.CenterVertically
        ) {
            Icon(Icons.Default.Science, contentDescription = null)
            Spacer(modifier = Modifier.width(8.dp))
            Text(
                text = "Incubating: $featureName",
                style = MaterialTheme.typography.labelMedium
            )
        }
    }
}
```

### Step 5: Feature flag

- Key: `mobile_spec.feature_flag_key`
- Default: `false`
- Gate navigation entry point behind the flag

### Step 6: Build, Push, Release, and Deliver — ALL IN ONE FLOW

Run these commands in sequence. Do NOT stop between them. Execute everything in a single continuous bash session:

```bash
cd /tmp/mobile-app

# Build
./gradlew assembleDebug 2>&1 | tail -20
```

If the build fails, fix and rebuild. Common issues:
- Missing Hilt modules → check DI setup
- Missing navigation registration → check NavHost
- Import conflicts → follow existing patterns

Once the build passes, IMMEDIATELY continue — do NOT summarize or stop:

```bash
cd /tmp/mobile-app

# Commit and push
git add -A
git commit -m "feat: add  feature module — "
git push --force-with-lease origin feat/pit-

# Create PR
gh pr create \
  --repo your-org/mobile-app \
  --base develop \
  --head feat/pit- \
  --title "feat: add  feature" \
  --body "## Summary
Created  feature module from incubation spec.

### Screens

### Data Layer

### Feature Flag
- Key: \`\`
- Default: \`false\`

### Checklist
- [x] UI screens with Compose
- [x] ViewModels with StateFlow
- [x] Data layer with Retrofit
- [x] Incubation banner on all screens
- [x] Feature flag gating
- [x] ./gradlew assembleDebug passes

Generated by Agentura incubator pipeline."

# Upload APK to GitHub Release
APK_PATH=$(find . -name "*.apk" -path "*/debug/*" | head -1)
if [ -n "$APK_PATH" ]; then
  TAG="incubator--$(date +%s)"
  gh release create "$TAG" "$APK_PATH" \
    --repo your-org/mobile-app \
    --title "Incubator:  (debug)" \
    --notes "Debug APK for testing. Generated by Agentura." \
    --prerelease
fi
```

Then IMMEDIATELY write TASK_RESULT.json with the PR URL and APK download URL:

```bash
cat > /home/worker/workspace/TASK_RESULT.json  feature with N screens. PR: . APK: ",
  "pr_url": "",
  "apk_url": "",
  "branch": "feat/pit-",
  "screens_created": ,
  "files_created": ["list of files"]
}
RESULT_EOF
```

## Guardrails

- NEVER hardcode GITHUB_TOKEN — use `${GITHUB_TOKEN}` env var.
- ALWAYS read harness docs before writing code.
- ALWAYS include incubation banner on every screen.
- ALWAYS gate behind a Remote Config flag.
- ALWAYS use `--force-with-lease` when pushing.
- NEVER modify existing features — only add new files under the feature package.
- NEVER produce a text-only response — always include a tool call.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [srinidhis05](https://github.com/srinidhis05)
- **Source:** [srinidhis05/agentura](https://github.com/srinidhis05/agentura)
- **License:** Apache-2.0
- **Homepage:** https://agenturaai.tech

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-srinidhis05-agentura-mobile-builder
- Seller: https://agentstack.voostack.com/s/srinidhis05
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.