Index of every page on this site: llms.txt
All skills
raintree-technology avatar

/hig-project-context

@a0f1e4e
Run it yourself

Create or update a shared Apple design context document that other HIG skills use to tailor guidance. Use when the user says "set up my project context," "what platforms am I targeting," "configure HIG settings," or when starting a new Apple platform project. Also activates when other HIG skills need project context but none exists yet. This skill creates .claude/apple-design-context.md so that hig-foundations, hig-platforms, hig-components-*, hig-inputs, and hig-technologies can provide targeted advice without repetitive questions.

Use this Skill: https://skilld.dev/gh/raintree-technology/hig-doctor/hig-project-context

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈140 tokens for metadata: the name and description. ≈1k when used: this file.

Description uses 7.0% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈560 characters, or 7.0%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Apple HIG: Project Context

Create and maintain .claude/apple-design-context.md so other HIG skills can skip redundant questions.

Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered.

Gathering Context

Before asking questions, auto-discover context from:

  1. README.md -- Product description, platform targets
  2. Package.swift / .xcodeproj -- Supported platforms, minimum OS versions, dependencies
  3. Info.plist -- App category, required capabilities, supported orientations
  4. Existing code -- Import statements reveal frameworks (SwiftUI vs UIKit, HealthKit, etc.)
  5. Assets.xcassets -- Color assets, icon sets, dark mode variants
  6. Accessibility audit -- Grep for accessibility modifiers/attributes

Present findings and ask the user to confirm or correct. Then gather anything still missing:

1. Product Overview

  • What does the app do? (one sentence)
  • Category (productivity, social, health, game, utility, etc.)
  • Stage (concept, development, shipped, redesign)

2. Target Platforms

  • Which Apple platforms? (iOS, iPadOS, macOS, tvOS, watchOS, visionOS)
  • Minimum OS versions
  • Universal or platform-specific?

3. Technology Stack

  • UI framework: SwiftUI, UIKit, AppKit, or mixed?
  • Architecture: single-window, multi-window, document-based?
  • Apple technologies in use? (HealthKit, CloudKit, ARKit, etc.)

4. Design System

  • System defaults or custom design system?
  • Brand colors, fonts, icon style?
  • Dark mode and Dynamic Type support status

5. Accessibility Requirements

  • Target level (baseline, enhanced, comprehensive)
  • Specific considerations (VoiceOver, Switch Control, etc.)
  • Regulatory requirements (WCAG, Section 508)

6. User Context

  • Primary personas (1-3)
  • Key use cases and environments (desk, on-the-go, glanceable, immersive)
  • Known pain points or design challenges

7. Existing Design Assets

  • Figma/Sketch files?
  • Apple Design Resources in use?
  • Existing component library?

Context Document Template

Generate .claude/apple-design-context.md using this structure:

# Apple Design Context

## Product
- **Name**: [App name]
- **Description**: [One sentence]
- **Category**: [Category]
- **Stage**: [Concept / Development / Shipped / Redesign]

## Platforms
| Platform | Supported | Min OS | Notes |
|----------|-----------|--------|-------|
| iOS      | Yes/No    |        |       |
| iPadOS   | Yes/No    |        |       |
| macOS    | Yes/No    |        |       |
| tvOS     | Yes/No    |        |       |
| watchOS  | Yes/No    |        |       |
| visionOS | Yes/No    |        |       |

## Technology
- **UI Framework**: [SwiftUI / UIKit / AppKit / Mixed]
- **Architecture**: [Single-window / Multi-window / Document-based]
- **Apple Technologies**: [List any: HealthKit, CloudKit, ARKit, etc.]

## Design System
- **Base**: [System defaults / Custom design system]
- **Brand Colors**: [List or reference]
- **Typography**: [System fonts / Custom fonts]
- **Dark Mode**: [Supported / Not yet / N/A]
- **Dynamic Type**: [Supported / Not yet / N/A]

## Accessibility
- **Target Level**: [Baseline / Enhanced / Comprehensive]
- **Key Considerations**: [List any specific needs]

## Users
- **Primary Persona**: [Description]
- **Key Use Cases**: [List]
- **Known Challenges**: [List]

Updating Context

When updating an existing context document:

  1. Read the current .claude/apple-design-context.md
  2. Ask what has changed
  3. Update only the changed sections
  4. Preserve all unchanged information

Related Skills

  • hig-platforms -- Platform-specific guidance
  • hig-foundations -- Color, typography, layout decisions
  • hig-patterns -- UX pattern recommendations
  • hig-components-* -- Component recommendations
  • hig-inputs -- Input method coverage
  • hig-technologies -- Apple technology relevance

Built by Raintree Technology · More developer tools

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts2mo5 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    The skill is safe to use. It automates the collection of Apple design context by reading local project files and generating a configuration document. All operations are local and aligned with the tool's intended purpose.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: LOW · No issues

  • Runlayer8mo

    1 file scanned · No issues

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at a0f1e4e. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 weeks ago.

Activeupdated 9 months ago
version
1.0.0

README badge

README badge for raintree-technology/hig-doctor/hig-project-context