Agent-Skills.md

Agent Skills: ti-guides

Titanium SDK official fundamentals and configuration guide. Use when working with, reviewing, analyzing, or examining Titanium projects, Hyperloop native access, app distribution (App Store/Google Play), tiapp.xml configuration, CLI commands, memory management, bridge optimization, CommonJS modules, SQLite transactions, or coding standards. AUTO-DETECT: If tiapp.xml exists, invoke this skill for any project configuration, build, or deployment question. Covers SDK versions, platform compatibility, and tiapp.xml settings that are unique to Titanium.

UncategorizedID: maccesar/titanium-sdk-skills/ti-guides
1

Install this agent skill to your local

pnpm dlx add-skill https://github.com/macCesar/titools/tree/HEAD/skills/ti-guides

Skill Files

Browse the full folder contents for ti-guides.

Download Skill

Loading file tree…

skills/ti-guides/SKILL.md

Skill Metadata

Name
ti-guides
Description
'Use when working on Titanium SDK fundamentals: project configuration (`tiapp.xml`, `timodule.xml`), CommonJS modules, Hyperloop native access, app distribution (App Store / Google Play, certificates, provisioning), Titanium CLI usage, memory management, bridge optimization, SQLite transactions, image memory, coding standards, the compatibility matrix (which JDK, Node.js, Xcode or Android SDK a given Titanium SDK needs), or what changed in a Titanium SDK release. Triggers include `tiapp.xml` in the project root, for either Alloy (`app/`) or Classic (`Resources/`) Titanium projects.'

ti-guides

Overview

Reference for Titanium SDK fundamentals: project configuration, distribution, native access via Hyperloop, CommonJS module patterns, memory and bridge optimization, and TiDev coding standards. Applies to both Alloy and Classic projects.

When to use

Use this skill when:

  • The project contains tiapp.xml (definitive Titanium project indicator)
  • Configuring tiapp.xml or timodule.xml
  • Setting up app distribution (App Store / Google Play, certificates, provisioning, AAB / IPA)
  • Using Hyperloop to call native APIs (Objective-C / Swift / Java)
  • Optimizing memory: removing global listeners, caching native properties, image memory footprints
  • Working with the Titanium CLI (ti build, ti sdk install, ti sdk select)
  • Checking which JDK, Node.js, Xcode or Android SDK a Titanium SDK version requires
  • Finding out what changed in a Titanium SDK release and whether it affects existing code
  • Writing CommonJS modules (stateful caching, ES6+ patterns, antipatterns)
  • Authoring AndroidManifest.xml overrides
  • Following TiDev style and naming conventions

Do NOT use for:

  • Alloy MVC concepts, controllers, models (use alloy-guides)
  • Alloy CLI usage and configuration files (use alloy-howtos)
  • Looking up specific Titanium API surfaces (use ti-api)
  • Native module dependency updates (use ti-module-update)

Quick reference

| Topic | Reference | |---|---| | Project creation, structure, getting started (Alloy or Classic) | hello-world.md | | JavaScript fundamentals, learning resources, ES6+ features | javascript-primer.md | | Alloy vs Classic Titanium, framework selection | application-frameworks.md | | Memory leaks, bridge efficiency, event naming, security, lazy loading | coding-best-practices.md | | Stateful modules, caching, ES6+ support, antipatterns | commonjs-advanced.md | | SQLite transactions and image memory optimization | advanced-data-and-images.md | | Hyperloop: Objective-C / Swift / Java syntax, casting, debugging, XIB / Storyboards | hyperloop-native-access.md | | Naming standards and formatting rules | style-and-conventions.md | | ECMAScript, iOS, and Alloy reserved keywords to avoid | reserved-words.md | | Custom AndroidManifest.xml, permissions, manifest merge | android-manifest.md | | Google Play (APK / AAB), App Store (IPA), certificates, provisioning, deployment | app-distribution.md | | Complete tiapp.xml and timodule.xml reference | tiapp-config.md | | Titanium CLI commands, options, tasks, configuration, build processes | cli-reference.md | | JDK, Node.js, Xcode and Android SDK versions each Titanium SDK supports | compatibility-matrix.md | | What changed per 13.x release, and which changes affect your code | sdk-release-notes.md | | Community support, modules, sample code, Slack, learning materials | resources.md |

Core practices

  1. Validate that the project follows a modular pattern (CommonJS or Alloy).
  2. Ensure global listeners are removed and heavy objects are nulled during cleanup.
  3. Cache frequently accessed native properties to reduce bridge crossings.
  4. Use Hyperloop for specialized native functionality and handle casting and threading correctly.
  5. Use transactions for database work and manage image memory footprints.

Procedural rules

  • Always remove Ti.App and Ti.Geolocation listeners during controller cleanup.
  • Do not access Ti.Platform or Ti.DisplayCaps inside loops. Store values in local variables.
  • Concatenate Hyperloop selectors accurately (for example, addAttribute:value:range: → addAttributeValueRange).
  • Close result sets and database handles after every transaction block.

Response format

When answering Titanium SDK questions:

  1. Technical recommendation — cite the specific TiDev best practice.
  2. Optimized implementation — provide modern ES6+ code.
  3. Rationale — briefly explain the performance or memory impact.

Related skills

| Task | Use this skill | |---|---| | Alloy MVC concepts, controllers, models, data binding | alloy-guides | | Alloy CLI, alloy.jmk, config.json, debugging | alloy-howtos | | Titanium API lookup (Ti.UI, Ti.Network, modules) | ti-api | | Native module dependency updates | ti-module-update |