@maccesar/titools 2.2.4 → 2.2.9

package/README.md

@@ -8,11 +8,11 @@
 
 </div>
 
-A CLI that gives your AI coding assistant access to **Titanium SDK** knowledge. One command installs 7 specialized skills, a research agent, and 100+ reference files for Titanium SDK, Alloy MVC, and PurgeTSS.
+TiTools is a CLI that installs Titanium SDK skills and a knowledge index for AI coding assistants. One command installs 7 skills, a research agent, and 100+ reference files for Titanium SDK, Alloy MVC, and PurgeTSS.
 
-Without `titools`, assistants fall back on general training data, which is often outdated or off-target for Titanium. With `titools`, your assistant can reference Alloy architecture, memory cleanup patterns, PurgeTSS utility classes, and platform-specific APIs.
+Without TiTools, assistants rely on general training data. That data can be outdated or too generic for Titanium work. With TiTools, the assistant can look up Alloy architecture, memory cleanup patterns, PurgeTSS utility classes, and platform-specific APIs.
 
-Based on [Vercel’s research on AGENTS.md](https://vercel.com/blog/agents-md-outperforms-skills-in-our-agent-evals), they found that the knowledge index approach achieved a 100% pass rate, compared to 53–79% using skills alone.
+Vercel's AGENTS.md evaluation reports a 100% pass rate for the knowledge index approach, compared to 53-79% using skills alone.
 
 ---
 
@@ -36,7 +36,7 @@ claude   # or gemini, or codex
 
 # 6) Ask away!
 # "How should I structure a new app with login, signup, and a dashboard?"
-# "My ListView with 500 items scrolls like garbage on Android. How do I fix it?"
+# "My ListView with 500 items scrolls poorly on Android. How do I fix it?"
 ```
 
 What gets installed:
@@ -125,15 +125,15 @@ The knowledge index is based on the latest Titanium SDK documentation. If your p
 
 ## Skills overview
 
-| Skill        | Purpose                       | Best For                                |
-| ------------ | ----------------------------- | --------------------------------------- |
-| alloy-guides | Alloy MVC reference           | Models, Views, Controllers, Widgets     |
-| alloy-howtos | Alloy CLI & debugging         | Project setup, CLI commands, errors     |
-| purgetss     | Utility-first styling         | UI styling and animations               |
-| ti-expert    | Architecture + Implementation | Starting point for most tasks           |
-| ti-guides    | SDK fundamentals              | Hyperloop, distribution, configuration  |
-| ti-howtos    | Native feature integration    | Location, Push, Media, Platform APIs    |
-| ti-ui        | UI/UX patterns                | Complex layouts, ListViews, platform UI |
+| Skill        | Purpose                         | Best For                                |
+| ------------ | ------------------------------- | --------------------------------------- |
+| alloy-guides | Alloy MVC reference             | Models, Views, Controllers, Widgets     |
+| alloy-howtos | Alloy CLI and debugging         | Project setup, CLI commands, errors     |
+| purgetss     | Utility-first styling           | UI styling and animations               |
+| ti-expert    | Architecture and implementation | Starting point for most tasks           |
+| ti-guides    | SDK fundamentals                | Hyperloop, distribution, configuration  |
+| ti-howtos    | Native feature integration      | Location, Push, Media, Platform APIs    |
+| ti-ui        | UI/UX patterns                  | Complex layouts, ListViews, platform UI |
 
 Note: `ti-guides`, `ti-howtos`, `ti-ui`, `alloy-guides`, and `alloy-howtos` are based on official Titanium SDK and Alloy documentation. `ti-expert` and `purgetss` are opinionated and reflect personal coding conventions (biased toward PurgeTSS).
 
@@ -206,9 +206,9 @@ All skills include automatic project detection to ensure compatibility:
 | ti-expert    | Alloy vs Classic      | Checks for `app/` (Alloy) vs `Resources/` (Classic) structure |
 | alloy-guides | Alloy projects        | Checks for `app/views/`, `app/controllers/`                   |
 | alloy-howtos | Alloy projects        | Checks for `alloy.jmk`, `config.json`                         |
-| ti-ui        | Titanium projects     | Checks for `tiapp.xml` (both Alloy & Classic)                 |
-| ti-guides    | Titanium projects     | Checks for `tiapp.xml` (both Alloy & Classic)                 |
-| ti-howtos    | Titanium projects     | Checks for `tiapp.xml` (both Alloy & Classic)                 |
+| ti-ui        | Titanium projects     | Checks for `tiapp.xml` (both Alloy and Classic)               |
+| ti-guides    | Titanium projects     | Checks for `tiapp.xml` (both Alloy and Classic)               |
+| ti-howtos    | Titanium projects     | Checks for `tiapp.xml` (both Alloy and Classic)               |
 
 Why this matters:
 - PurgeTSS suggestions are only provided if PurgeTSS is installed
@@ -620,8 +620,8 @@ Behavior depends on where you run it:
 
 What it does:
 1. Checks GitHub for the latest CLI version
-2. If a newer version exists → prompts you to update the CLI first with `npm update -g @maccesar/titools`
-3. If CLI is current → syncs skills and agents from the installed package (no download needed)
+2. If a newer version exists, it prompts you to update the CLI first with `npm update -g @maccesar/titools`
+3. If the CLI is current, it syncs skills and agents from the installed package (no download needed)
 4. Updates platform symlinks only for platforms that already have them
 5. Cleans up legacy artifacts (`alloy-expert` skill, `ti-researcher` agent)
 6. Auto-syncs knowledge index files if they exist in the current project
@@ -691,13 +691,13 @@ Codex CLI:
 
 | Skill        | SKILL.md                      | References                                            |
 | ------------ | ----------------------------- | ----------------------------------------------------- |
-| ti-expert    | Architecture + Implementation | 19 refs + 1 asset (patterns, testing, security, etc.) |
-| purgetss     | Setup + Critical Rules        | 21 files (grid, animations, icons, class-index, etc.) |
-| ti-ui        | UI Rules + Platform Diffs     | 14 files (layouts, lists, gestures, etc.)             |
-| ti-howtos    | Integration Workflow          | 18 files (location, media, maps, automation, etc.)    |
-| ti-guides    | Core Workflow                 | 14 files (hyperloop, distribution, etc.)              |
 | alloy-guides | MVC Quick Start               | 10 files (models, views, widgets, etc.)               |
 | alloy-howtos | Best Practices                | 6 files (CLI, config, debugging, etc.)                |
+| purgetss     | Setup + Critical Rules        | 21 files (grid, animations, icons, class-index, etc.) |
+| ti-expert    | Architecture + Implementation | 19 refs + 1 asset (patterns, testing, security, etc.) |
+| ti-guides    | Core Workflow                 | 14 files (hyperloop, distribution, etc.)              |
+| ti-howtos    | Integration Workflow          | 18 files (location, media, maps, automation, etc.)    |
+| ti-ui        | UI Rules + Platform Diffs     | 14 files (layouts, lists, gestures, etc.)             |
 
 ---
 

package/agents/ti-pro.md

@@ -1,6 +1,6 @@
 ---
 name: ti-pro
-description: Titanium SDK and Alloy research specialist. Preloads all 7 titanium-related skills for comprehensive analysis. Use proactively for: analyzing Titanium/Alloy codebases, reviewing Alloy app architecture, researching Titanium SDK implementations, exploring mobile app architectural questions, multi-feature research across Titanium APIs, cross-referencing framework patterns, or investigating platform-specific Titanium differences. Returns findings with specific file/line references from all documentation.
+description: Titanium SDK and Alloy research specialist. Loads the 7 Titanium skills and uses them together to answer research-style questions. Use for codebase analysis, architecture reviews, Titanium SDK implementation research, cross-feature questions, and platform-specific differences. Returns concrete findings with file and line references.
 skills:
   - alloy-guides
   - alloy-howtos
@@ -15,27 +15,27 @@ model: sonnet
 
 # Titanium SDK Research Specialist
 
-You are a deep-dive research specialist for Titanium SDK and Alloy mobile development.
+You are a research specialist for Titanium SDK and Alloy mobile development. With more than 15 year of experience.
 
 ## What You Do
 
-When invoked, you research complex topics by consulting **all 7 preloaded titanium-\*** skills:
+When invoked, you research complex topics by consulting all 7 Titanium skills:
 
 - `ti-expert` - Architecture, patterns, conventions
 - `alloy-guides` - Alloy MVC complete reference
 - `alloy-howtos` - CLI, config, debugging
-- `purgetss` - Utility-first styling classes (optional addon — use when the project already has it or the user asks about it)
+- `purgetss` - Utility-first styling classes (optional add-on; use when the project already has it or the user asks about it)
 - `ti-guides` - SDK official guides, Hyperloop, distribution
 - `ti-howtos` - Native features, platform-specific APIs
 - `ti-ui` - UI/UX patterns, layouts, gestures
 
 ## Research Process
 
-1. **Understand the query** - What specific aspect needs research?
-2. **Consult ALL relevant skills** - All skills are preloaded in your context
-3. **Cross-reference** - Find connections across multiple skills
-4. **Provide specifics** - Include file paths, line numbers, code examples
-5. **Cite sources** - Reference which skill and file each answer comes from
+1. **Understand the query** - Identify what needs research.
+2. **Consult all relevant skills** - Use the full set.
+3. **Cross-reference** - Connect findings across skills.
+4. **Provide specifics** - Include file paths, line numbers, and code examples.
+5. **Cite sources** - Note which skill and file each answer comes from.
 
 ## What You're Good For
 
@@ -47,7 +47,7 @@ When invoked, you research complex topics by consulting **all 7 preloaded titani
 | **Architecture review**    | "Review this project's folder structure and service layer"         |
 | **Platform differences**   | "Research iOS vs Android differences for this feature"             |
 
-## What You're NOT For
+## What You're Not For
 
 | Use Instead                                  | Reason                                 |
 | -------------------------------------------- | -------------------------------------- |
@@ -60,11 +60,11 @@ When invoked, you research complex topics by consulting **all 7 preloaded titani
 
 When returning research findings:
 
-1. **Summary** - Brief overview of findings
-2. **Key Points** - Bulleted list with specific references
-3. **Code Examples** - From the skills, with source citations
-4. **Related Skills** - Which skills were consulted
-5. **File References** - Specific `path:line` format
+1. **Summary** - Brief overview of findings.
+2. **Key Points** - Bulleted list with specific references.
+3. **Code Examples** - From the skills, with source citations.
+4. **Related Skills** - Which skills were consulted.
+5. **File References** - Specific `path:line` format.
 
 Example:
 ```markdown
@@ -81,7 +81,7 @@ Your app uses `Ti.App.fireEvent` which causes memory leaks.
 
 ## Tool Usage
 
-You have **read-only tools**: `Read`, `Grep`, `Glob`, `Bash`
+You have read-only tools: `Read`, `Grep`, `Glob`, `Bash`.
 
 Use them to:
 - Search the codebase when asked to analyze it
@@ -89,7 +89,7 @@ Use them to:
 - Verify claims against actual code
 - List files/directories and inspect structure with shell commands
 
-You **cannot** modify files. If the user asks for changes, provide the research and suggest using the appropriate skill or main conversation for implementation.
+You cannot modify files. If the user asks for changes, provide the research and suggest using the appropriate skill or main conversation for implementation.
 
 ---
 

package/lib/commands/update.js

@@ -23,7 +23,7 @@ import {
 import { agentsCommand } from './agents.js';
 import {
   checkForUpdate,
-  fetchLatestVersion,
+  fetchLatestNpmVersion,
 } from '../downloader.js';
 import { createSkillSymlinks } from '../symlink.js';
 import { formatList, isTitaniumProject } from '../utils.js';
@@ -125,7 +125,7 @@ export async function updateCommand(options) {
     if (hasUpdate) {
       let latestVersion = '(newer)';
       try {
-        latestVersion = await fetchLatestVersion();
+        latestVersion = await fetchLatestNpmVersion();
       } catch {
         // Ignore error, we already know there's an update
       }
@@ -167,7 +167,7 @@ export async function updateCommand(options) {
     // Install skills
     spinner.start('Syncing skills...');
     const skillsResult = await installSkills(repoDir, baseDir);
-    spinner.succeed(`Skills: ${formatList(skillsResult.installed)}`);
+    spinner.succeed(`${skillsResult.installed.length} skills updated`);
 
     // Install agents (only if Claude Code has symlinks)
     const claudePlatform = platformsWithSymlinks.find((p) => p.name === 'claude');
@@ -175,7 +175,7 @@ export async function updateCommand(options) {
       spinner.start('Syncing agents...');
       const agentsResult = await installAgents(repoDir, baseDir);
       if (agentsResult.installed.length > 0) {
-        spinner.succeed(`Agents: ${formatList(agentsResult.installed)}`);
+        spinner.succeed('Platform agents updated');
       } else {
         spinner.info('No agents to sync');
       }
@@ -183,21 +183,13 @@ export async function updateCommand(options) {
 
     cleanupLegacyArtifacts(baseDir);
 
-    // Update symlinks only for platforms that already had them
+    // Update symlinks silently for platforms that already had them
     for (const platform of platformsWithSymlinks) {
-      spinner.start(`Updating ${platform.displayName} symlinks...`);
-      const symlinkResult = await createSkillSymlinks(
+      await createSkillSymlinks(
         platform.skillsDir,
         SKILLS,
         baseDir
       );
-      if (symlinkResult.linked.length === SKILLS.length) {
-        spinner.succeed(`${platform.displayName} linked`);
-      } else {
-        spinner.warn(
-          `${platform.displayName}: ${symlinkResult.linked.length}/${SKILLS.length} linked`
-        );
-      }
     }
 
     // Summary

package/lib/downloader.js

@@ -112,13 +112,28 @@ export async function downloadRawFile(filePath, destPath, ref = 'main') {
 }
 
 /**
- * Check if an update is available
+ * Fetch latest version from npm registry
+ * @returns {Promise<string>} Latest version number
+ */
+export async function fetchLatestNpmVersion() {
+  const response = await fetch('https://registry.npmjs.org/@maccesar/titools');
+
+  if (!response.ok) {
+    throw new Error(`Failed to fetch npm info: ${response.statusText}`);
+  }
+
+  const data = await response.json();
+  return data['dist-tags'].latest;
+}
+
+/**
+ * Check if an update is available (checks npm)
  * @param {string} currentVersion - Current version
  * @returns {Promise<boolean>} True if update available
  */
 export async function checkForUpdate(currentVersion) {
   try {
-    const latestVersion = await fetchLatestVersion();
+    const latestVersion = await fetchLatestNpmVersion();
     // Remove 'v' prefix if present
     const latest = latestVersion.replace(/^v/, '');
     const current = currentVersion.replace(/^v/, '');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maccesar/titools",
-  "version": "2.2.4",
+  "version": "2.2.9",
   "description": "Titanium SDK skills and agents for AI coding assistants (Claude Code, Gemini CLI, Codex CLI)",
   "main": "lib/index.js",
   "type": "module",

package/skills/alloy-guides/SKILL.md

@@ -5,11 +5,11 @@ argument-hint: "[concept]"
 allowed-tools: Read, Grep, Glob, Edit, Write, Bash(node *)
 ---
 
-# Alloy MVC Framework Guide
+# Alloy MVC framework guide
 
-Complete reference for building Titanium mobile applications with the Alloy MVC framework and Backbone.js.
+Reference for building Titanium mobile applications with the Alloy MVC framework and Backbone.js.
 
-## Project Detection
+## Project detection
 
 :::info AUTO-DETECTS ALLOY PROJECTS
 This skill automatically detects Alloy projects when invoked and provides framework-specific guidance.
@@ -26,7 +26,7 @@ This skill automatically detects Alloy projects when invoked and provides framew
 - **Not detected** → Indicates this skill is for Alloy projects only, does not suggest Alloy-specific features
 :::
 
-## Quick Reference
+## Quick reference
 
 | Topic                                            | Reference File                                                          |
 | ------------------------------------------------ | ----------------------------------------------------------------------- |
@@ -41,7 +41,7 @@ This skill automatically detects Alloy projects when invoked and provides framew
 | CLI commands, code generation                    | [CLI_TASKS.md](references/CLI_TASKS.md)                                 |
 | PurgeTSS integration (optional addon)            | [PURGETSS.md](references/PURGETSS.md)                                   |
 
-## Project Structure
+## Project structure
 
 Standard Alloy project structure:
 
@@ -64,7 +64,7 @@ app/
 └── widgets/              # Widget components
 ```
 
-## MVC Quick Start
+## MVC quick start
 
 **Controller** (`app/controllers/index.js`):
 ```javascript
@@ -89,7 +89,7 @@ $.index.open();
 "Label": { color: "#000" }
 ```
 
-## Key Concepts
+## Key concepts
 
 - **Models/Collections**: Backbone.js objects with sync adapters (sql, properties)
 - **Views**: XML markup with TSS styling
@@ -98,29 +98,29 @@ $.index.open();
 - **Widgets**: Reusable components with MVC structure
 - **Conventions**: File naming and placement drive code generation
 
-## Critical Rules
+## Critical rules
 
-### Platform-Specific Properties in TSS
+### Platform-specific properties in TSS
 
-:::danger CRITICAL: Platform-Specific Properties Require Modifiers
-Using `Ti.UI.iOS.*` or `Ti.UI.Android.*` properties in TSS WITHOUT platform modifiers causes cross-platform compilation failures.
+:::danger CRITICAL: Platform-specific properties require modifiers
+Using `Ti.UI.iOS.*` or `Ti.UI.Android.*` properties in TSS without platform modifiers causes cross-platform compilation failures.
 
-**Example of the damage:**
+Example of the failure:
 ```tss
-// ❌ WRONG - Adds Ti.UI.iOS to Android project
+// WRONG - Adds Ti.UI.iOS to Android project
 "#mainWindow": {
   statusBarStyle: Ti.UI.iOS.StatusBar.LIGHT_CONTENT  // FAILS on Android!
 }
 ```
 
-**CORRECT approach - Use platform modifiers:**
+Correct approach - use platform modifiers:
 ```tss
-// ✅ CORRECT - Only adds to iOS
+// CORRECT - Only adds to iOS
 "#mainWindow[platform=ios]": {
   statusBarStyle: Ti.UI.iOS.StatusBar.LIGHT_CONTENT
 }
 
-// ✅ CORRECT - Only adds to Android
+// CORRECT - Only adds to Android
 "#mainWindow[platform=android]": {
   actionBar: {
     displayHomeAsUp: true
@@ -128,23 +128,23 @@ Using `Ti.UI.iOS.*` or `Ti.UI.Android.*` properties in TSS WITHOUT platform modi
 }
 ```
 
-**Properties that ALWAYS require platform modifiers:**
+Properties that always require platform modifiers:
 - iOS: `statusBarStyle`, `modalStyle`, `modalTransitionStyle`, any `Ti.UI.iOS.*`
 - Android: `actionBar` config, any `Ti.UI.Android.*` constant
 
 **Available modifiers:** `[platform=ios]`, `[platform=android]`, `[formFactor=handheld]`, `[formFactor=tablet]`, `[if=Alloy.Globals.customVar]`
 
-**For more platform-specific patterns, see** [Code Conventions (ti-expert)](skills/ti-expert/references/code-conventions.md#platform--device-modifiers) or [Platform UI guides (ti-ui)](skills/ti-ui/references/platform-ui-ios.md).
+For more platform-specific patterns, see [Code conventions (ti-expert)](skills/ti-expert/references/code-conventions.md#platform--device-modifiers) or [Platform UI guides (ti-ui)](skills/ti-ui/references/platform-ui-ios.md).
 :::
 
-## Common Patterns
+## Common patterns
 
-### Creating a Model
+### Creating a model
 ```bash
 alloy generate model book sql title:string author:string
 ```
 
-### Data Binding
+### Data binding
 ```xml
 <Collection src="book" />
 <TableView dataCollection="book">
@@ -152,7 +152,7 @@ alloy generate model book sql title:string author:string
 </TableView>
 ```
 
-### Platform-Specific Code
+### Platform-specific code
 ```javascript
 if (OS_IOS) {
     // iOS-only code
@@ -162,25 +162,25 @@ if (OS_ANDROID) {
 }
 ```
 
-### Widget Usage
+### Widget usage
 ```xml
 <Widget src="mywidget" id="foo" />
 ```
 
-## Compilation Process
+## Compilation process
 
-1. **Cleanup**: Resources folder cleaned
-2. **Build Config**: alloy.jmk loaded (pre:load task)
-3. **Framework Files**: Backbone.js, Underscore.js, sync adapters copied
-4. **MVC Generation**: Models, widgets, views, controllers compiled to JS
-5. **Main App**: app.js generated from template
-6. **Optimization**: UglifyJS optimization, platform-specific code removal
+1. Cleanup: Resources folder cleaned
+2. Build Config: alloy.jmk loaded (pre:load task)
+3. Framework Files: Backbone.js, Underscore.js, sync adapters copied
+4. MVC Generation: Models, widgets, views, controllers compiled to JS
+5. Main App: app.js generated from template
+6. Optimization: UglifyJS optimization, platform-specific code removal
 
 ## References
 
 Read detailed documentation from the reference files listed above based on your specific task.
 
-## Related Skills
+## Related skills
 
 For tasks beyond Alloy MVC basics, use these complementary skills:
 

package/skills/alloy-guides/references/CONCEPTS.md

@@ -6,7 +6,7 @@ This guide covers the important concepts related to the Alloy framework, includi
 
 ## Model-View-Controller
 
-Alloy utilizes the model-view-controller (MVC) pattern, which separates the application into three different components:
+Alloy uses the model-view-controller (MVC) pattern, which separates the application into three different components:
 
 * **Models** provide the business logic, containing the rules, data and state of the application
 
@@ -26,7 +26,7 @@ Alloy views are built from Titanium UI components. You define views using XML ma
 
 Alloy controllers generally have a one-to-one relationship with Alloy views. Controllers directly use the Titanium SDK API without an abstraction layer. The controller has access to all of the view components.
 
-Additionally, Alloy provides built-in support for Underscore.js, which provides a set of utility functions, such as array and iterative helpers.
+Also, Alloy provides built-in support for Underscore.js, which provides a set of utility functions, such as array and iterative helpers.
 
 ## Alloy and the Titanium SDK
 
@@ -103,7 +103,7 @@ app/
 
 Alternatively, you can use special conditional code and attributes inside the controllers, views and styles to apply platform-specific code and components.
 
-Additionally, the `assets` folder is laid out the same way as the `Resources` folder in a Titanium project for platform-specific files and density-specific images.
+Also, the `assets` folder is laid out the same way as the `Resources` folder in a Titanium project for platform-specific files and density-specific images.
 
 ## Widgets
 

package/skills/alloy-guides/references/CONTROLLERS.md

@@ -137,7 +137,7 @@ if (OS_IOS) {
 
 ### Passing Arguments
 
-When initializing an external controller, you can pass arguments to customize it, for instance, `const controller = Alloy.createController('controller', {args1: 'foo'})`. In the external controller, the special variable `$.args` is used to receive the arguments. Prior to Alloy 1.6, you needed to use `arguments[0]`. For example, suppose you want to add multiple TableViewRow objects to a TableView object.
+When initializing an external controller, you can pass arguments to customize it, for instance, `const controller = Alloy.createController('controller', {args1: 'foo'})`. In the external controller, the special variable `$.args` is used to receive the arguments. Before Alloy 1.6, you needed to use `arguments[0]`. For example, suppose you want to add multiple TableViewRow objects to a TableView object.
 
 For the TableViewRow object, called 'row', the view contains only the object, and the controller contains only a few lines of code to parse the arguments:
 

package/skills/alloy-guides/references/MODELS.md

@@ -11,7 +11,7 @@
 
 Alloy uses Backbone.js to provide support for its models and collections. Alloy also borrows the concepts of migrations and adapters from Rails for storage integration.
 
-For models, collections and sync adapters, these guides only provides information on how Alloy utilizes the Backbone.js functionality and some simple examples of using it.
+For models, collections and sync adapters, these guides only provides information on how Alloy uses the Backbone.js functionality and some simple examples of using it.
 
 ## Alloy Collection and Model Objects
 
@@ -214,7 +214,7 @@ exports.definition = {
 
 #### Underscore.js Functionality
 
-Additionally, the Backbone.Collection class inherits some functionality from [Underscore.js](https://underscorejs.org/), which can help simplify iterative functions. For example, to add the title of each book object in the library collection to a table, you could use the `map` function to set the table:
+Also, the Backbone.Collection class inherits some functionality from [Underscore.js](https://underscorejs.org/), which can help simplify iterative functions. For example, to add the title of each book object in the library collection to a table, you could use the `map` function to set the table:
 
 **Iterating over a collection with underscore**
 
@@ -281,7 +281,7 @@ You can bind both a collection of models or an individual model. To bind a model
 
 ### Global Singleton vs Local Instance
 
-In the above code snippet, the model and collection are global singletons under `Alloy.Models.currentCategory` and `Alloy.Collections.book`. You can also use local instances for the current controller by adding `instance="true"` as attribute. You also need to assign them an ID in order to reference them in the XML and controller.
+In the above code snippet, the model and collection are global singletons under `Alloy.Models.currentCategory` and `Alloy.Collections.book`. You can also use local instances for the current controller by adding `instance="true"` as attribute. You also need to assign them an ID to reference them in the XML and controller.
 
 ```xml
 <Alloy>
@@ -360,7 +360,7 @@ You can bind deep object properties:
 
 Before, you needed to use a transformer to create a reference like `authorName`.
 
-Prior to CLI 7.1.0, the only way to set object properties (e.g. `font.fontFamily` for a Label) was to use TSS. You can use dot notation in XML:
+Before CLI 7.1.0, the only way to set object properties (e.g. `font.fontFamily` for a Label) was to use TSS. You can use dot notation in XML:
 
 ```xml
 <Alloy>
@@ -760,7 +760,7 @@ The sync adapter exports three functions:
 
 ### Migrations
 
-A migration is a description of incremental changes to a database, which takes your database from version 1 to version X, with a migration file for each step in the evolution of your database schema. This is helpful to keep different versions of a database in sync. For example, when version 7 of your application is deployed, migrations are able to successfully update the database from versions 1 through 6. Currently, migrations are only used with the `sql` sync adapter.
+A migration is a description of incremental changes to a database, which takes your database from version 1 to version X, with a migration file for each step in the evolution of your database schema. This is helpful to keep different versions of a database in sync. For example, when version 7 of your application is deployed, migrations can successfully update the database from versions 1 through 6. Currently, migrations are only used with the `sql` sync adapter.
 
 The `migration.up` function upgrades the database from the previous version, while the `migration.down` function rolls back the changes to the previous version.
 
@@ -1014,7 +1014,7 @@ To use Backbone 1.1.2 to support Alloy Model and Collections objects, open the p
 
 #### Model APIs
 
-**Validation**: Model validation is now only enforced with the `save()` method. Previously, models were also validated with the `set()` method. To force validation when the `set()` method is called, pass `{validate: true}` to the method or extend the Model class. Additionally, validation now occurs even during 'silent' changes (passing `{silent: true}` to methods). Previously, it would not. Failed validations return the `invalid` event. Previously, a failed model validation would return the `error` event.
+**Validation**: Model validation is now only enforced with the `save()` method. Previously, models were also validated with the `set()` method. To force validation when the `set()` method is called, pass `{validate: true}` to the method or extend the Model class. Also, validation now occurs even during 'silent' changes (passing `{silent: true}` to methods). Previously, it would not. Failed validations return the `invalid` event. Previously, a failed model validation would return the `error` event.
 
 **Parse Method**: All `parse` methods now run after a `fetch`. You cannot change the `id` of a model during `parse`. The `parse` method receives `options` as a second parameter.
 

package/skills/alloy-guides/references/VIEWS_WITHOUT_CONTROLLERS.md

@@ -84,7 +84,7 @@ $.index.add(profile.getView());
 $.index.open();
 ```
 
-**Prior to Alloy 1.4.0**, to dynamically generate a view:
+**Before Alloy 1.4.0**, to dynamically generate a view:
 
 1. Create a new instance of the controller using `Alloy.createController()`.
 2. Modify the properties directly.

package/skills/alloy-guides/references/VIEWS_XML.md

@@ -354,7 +354,7 @@ For UI objects that belong to a specific platform, use the `platform` attribute:
 <SplitWindow platform="ios"/>
 ```
 
-Additionally, use the alias `Ti` for `Titanium` when specifying namespaces.
+Also, use the alias `Ti` for `Titanium` when specifying namespaces.
 
 Many of the Titanium view proxies not part of the `Titanium.UI` namespace do not require that the `ns` attribute be explicitly set. The following elements are implicitly mapped to a namespace:
 

package/skills/alloy-guides/references/WIDGETS.md

@@ -10,7 +10,7 @@ See [Importing Widgets](./VIEWS_XML.md#importing-widgets) for more information o
 
 ## Creating Widgets
 
-Widgets should be built in their own directory in the Alloy project's `app/widgets/` directory. Widgets have their own views, controllers, models, styles and assets and are laid out the same as the `app` directory in the Alloy project. Additionally, since widgets are self-contained, they should not reference any code or assets not within its path, except for internationalization and localization files, which are located in the `i18n` folder.
+Widgets should be built in their own directory in the Alloy project's `app/widgets/` directory. Widgets have their own views, controllers, models, styles and assets and are laid out the same as the `app` directory in the Alloy project. Also, since widgets are self-contained, they should not reference any code or assets not within its path, except for internationalization and localization files, which are located in the `i18n` folder.
 
 ## Assets and Libs