mcpField
A
appfunctions

appfunctions

github.com/androidDevelopment10.0k1.6k installsUpdated 2d ago
Repository

About appfunctions

An Android development skill for identifying app workflows that can be exposed as AppFunctions, then generating Kotlin implementations and refining their KDoc. It also covers configuration and ADB-based testing for system agents.

Key features

  1. 01Discovering candidate app workflows
  2. 02Generating Kotlin AppFunctions
  3. 03Configuring dependencies and system settings
  4. 04Refining KDoc for agents
  5. 05Testing with ADB commands

Use cases

  1. 01Finding app actions for system agents
  2. 02Implementing AppFunctions in Kotlin
  3. 03Improving function descriptions for agents
  4. 04Checking function registration on a device

MCP support

It supports refining AppFunction KDoc for MCP and LLM interpretation. AppFunctions expose Android app workflows for system agents; the skill does not describe an MCP server.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/android/skills --skill appfunctions

After installing, type/appfunctionsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
adb-interaction-testing.md
context.md
feature-discovery-analysis.md
implementation-configuration.md
kdoc-refinement-optimization.md
migrate-to-service-entry-point.md

Details

From the project README

Analyzes Android apps to identify key user workflows for AppFunctions such as creating a note, playing media, or sending an automated or AI agent triggered message, voice commands, or system shortcuts, without needing to open the app UI.

Generates Kotlin code to expose these workflows to the Android system, allowing agents to discover and execute them on-device.

Also refines KDoc documentation to ensure AI agents correctly understand and use the provided functionality.

Prerequisites

The app must targetSdk 36 or newer and use compileSdk 37 or newer as AppFunctions, part of the Android platform API, are available from Android 16 onwards. Always use the Jetpack library because it handles backward compatibility.

Workflows

This skill enables the caller to discover features that will be provided to system agents, implement these with AppFunctions, improve function description for agents, and use ADB commands for local evaluation and testing.

The full AppFunction development flow consists of these four steps:

  • Step 1: Discovery: Analyze Android codebases to identify and recommend potential AppFunctions. Use this step when a user asks to "discover AppFunctions," "find features for AI," or "analyze my app for agentic tools."
  • Step 2: Implementation and configuration: Generate Kotlin implementations of AppFunctions, manage system-wide configuration, and configure build dependencies. Use this step when a user asks to "implement AppFunctions," "set up the AppFunctions framework," or "configure Hilt for AppFunctions."
  • Step 3: KDoc refinement: Optimize AppFunction KDoc for AI agents and Model Context Protocol. If a user asks to "write KDoc", "optimize for MCP", or "refactor tool descriptions for LLMs", use this step.
  • Step 4: Testing and debugging: Provide commands to interact with AppFunctions using ADB for testing and debugging. If a user wants to "list app functions", "invoke an app function", or "verify app function registration" on a device, use this step.

If users request a subset of steps, you must encourage them to use all steps.

If they apply, you must load the following references:

  • Context and terminology: Defines the ubiquitous language, architecture definitions, and design patterns across the AppFunctions skill suite. Load when you need to understand core architecture terminology or check the distinctions between modern and legacy AppFunctions APIs.
  • Migration to service entry point : Documents the systematic procedure for migrating Android applications using AppFunctions versions 1.0.0-alpha09 and lower to AppFunctionServiceEntryPoint architecture introduced in version 1.0.0-alpha10. Load when a user asks to migrate or upgrade existing AppFunctions code, or when you encounter legacy AppFunctionConfiguration.Provider implementations.

Critical constraints

  • Modular consistency: You must refine KDocs immediately after you generate AppFunction implementations.
  • Security: Don't expose sensitive data or run destructive actions without user confirmation.

Troubleshooting

Comments

Markdown supported