Skill Sets
In a mobile project, knowledge of smartlime and Expo is built into the project in advance as a convention file and skill sets, and the agent refers to them.
smartlime is an SDK for working with iAP, and using it correctly requires knowledge specific to iAP authentication and APIs. In addition, Expo APIs change with each SDK version, so the usage an agent remembers may be outdated. The skill sets enable the agent to implement features in the correct way for the project's SDK.
Skill Set Structure
The following files are deployed according to the selected agents.
| File / directory | Claude Code | Codex | Contents |
|---|---|---|---|
AGENTS.md | ○ | ○ | Convention file. Project overview, which skill to use for which task, and common rules |
CLAUDE.md | ○ | Loads AGENTS.md | |
.claude/skills/ | ○ | smartlime skill set | |
.claude/settings.json | ○ | Setting that enables the official Expo plugin for Claude Code | |
.agents/skills/ | ○ | smartlime skill set and the official Expo skills (if you chose to install them) | |
.codex/config.toml | ○ | Expo MCP server settings |
Convention File (AGENTS.md)
AGENTS.md summarizes what the agent must always follow. Its main contents are as follows.
- Project overview: The Expo SDK and the iAP version the app works with, the role of each smartlime package, and the prerequisites on the iAP side
- Which skill to use: The smartlime skill to use for each kind of task. Official Expo skills are used for work on Expo itself
- Common rules: Call iAP APIs with
useIMFetch, do not write OAuth connection information directly in the source code, and run the tests at the end of the work - Expo basics: Check Expo APIs in the documentation for the version in use instead of writing them from memory, add packages with
npx expo install, run lint and type checking before finishing the work, and use Expo Router for screen navigation
The "Expo basics" section is a translation of the AGENTS.md provided by create-expo.
smartlime Skill Set
The smartlime skill set describes how to use smartlime-specific features and the steps to implement them. The agent refers to the corresponding skill according to the request.
| Skill | Purpose | Example trigger phrases |
|---|---|---|
smartlime-setup | Introducing smartlime and configuring the connection to iAP. Adding packages, the URL scheme and redirect URI, handling connection information, placing Smartlime, and the values for registering the OAuth client on iAP | Introduce smartlime; configure the connection to iAP |
smartlime-auth | Login screen, logout, switching screens by login state, and logged-in user information | Create a login screen with a logout button |
smartlime-api | Calling iAP REST APIs (such as the IM-Workflow REST API) and handling errors | Get the list of IM-Workflow matters |
smartlime-webview | Displaying iAP screens inside the app | Open the workflow application screen in the app |
smartlime-search | Searching for and selecting users, organizations, positions, public groups, and roles | Let the user search for and select a person in charge |
smartlime-calendar | Displaying an iAP calendar (business days and holidays) and selecting a date | Let the user pick the application date from a calendar |
smartlime-assistant | Chatting with an IM-Copilot assistant | Create a screen for conversations with an IM-Copilot assistant |
smartlime-testing | Testing code that uses smartlime (Jest) | Write tests for the screens you created |
Official Expo Skills
For work on Expo itself, such as screen navigation, UI, native features, SDK upgrades, and building and distribution, the skills published by Expo are used.
- Claude Code: Uses the skills included in the official Expo plugin for Claude Code. The plugin is enabled by the setting in
.claude/settings.json. - Codex: If you chose to install them when creating the project, the official Expo skills are installed into
.agents/skills/. To install them later or update them, use the command shown by Accel CLI ornpx skills update.
After signing in with an Expo account, the agent can use the MCP server provided by Expo (https://mcp.expo.dev/mcp). Sign in with /mcp in Claude Code, or with codex mcp login expo in Codex.
Customizing Skill Sets
As with iAP projects, you can edit the skill sets and add your own. See Skill Set Customization in Tutorial - Skill Sets.