hig-project-context
Create or update a shared Apple design context document that other HIG skills use to tailor guidance.
Best use case
hig-project-context is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Create or update a shared Apple design context document that other HIG skills use to tailor guidance.
Teams using hig-project-context should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/hig-project-context/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How hig-project-context Compares
| Feature / Agent | hig-project-context | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Create or update a shared Apple design context document that other HIG skills use to tailor guidance.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# 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: ```markdown # 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](https://raintree.technology) · [More developer tools](https://raintree.technology)* ## When to Use This skill is applicable to execute the workflow or actions described in the overview.
Related Skills
context-compression
Design and evaluate compression strategies for long-running sessions
recursive-context-coding-agent
Use recursive context processing with grep/find/uv to handle large codebases. When working with codebases larger than your context window, treat the codebase as an external environment and recursively process it using symbolic execution.
project-spec
Create a project spec for AI agents to work from autonomously.
project-orchestrator
Master coordinator for complete project setup from ideation to ready-to-code. Manages workflow through ideation, research, tech stack selection, documentation, and project initialization to deliver working projects in minutes.
project-domain
Capture subject matter expertise and domain knowledge that will inform all product decisions - the ubiquitous language, domain rules, and principles from the field
project-bootstrap
Bootstrap a new or existing project with stack detection and project.json generation. Use when adding a new project, setting up agent system, or generating project manifest. Triggers on: add project, new project, bootstrap project, setup project, detect stack.
extracting-ai-context
Extracts and manages AI context (skills, AGENTS.md) from workflow-kotlin library JARs. Use when setting up AI tooling for a workflow-kotlin project, updating skills after a library version change, or configuring agent-specific directories.
create-agent-with-sanity-context
Build AI agents with structured access to Sanity content via Context MCP. Covers Studio setup, agent implementation, and advanced patterns like client-side tools and custom rendering.
context-optimizer
Analyzes Copilot Chat debug logs, agent definitions, skills, and instruction files to audit context window utilization. Provides log parsing, turn-cost profiling, redundancy detection, hand-off gap analysis, and optimization recommendations. Use when optimizing agent context efficiency, identifying where to add subagent hand-offs, or reducing token waste across agent systems.
context-fundamentals
Understand the components, mechanics, and constraints of context in agent systems. Use when designing agent architectures, debugging context-related failures, or optimizing context usage.
context-engineering
Use when designing agent system prompts, optimizing RAG retrieval, or when context is too expensive or slow. Reduces tokens while maintaining quality through strategic positioning and attention-aware design.
context-degradation
Recognize patterns of context failure: lost-in-middle, poisoning, distraction, and clash