Agent skill
apple-dev-safety-and-docs
Enforce mutation safety in Xcode-managed projects and route Apple and Swift documentation through Dash local-first policy with cooldown-gated advisory messaging. Use for risk checks, consent gating, docs fallback decisions, and skill-install guidance in Apple development workflows.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/apple-dev-safety-and-docs
SKILL.md
Apple Dev Safety and Docs
Use this skill for risk gating and documentation routing.
Hard Mutation Gate (Required)
Before direct filesystem mutation in Xcode-managed scope, require all steps:
- warn user about risks in
.xcodeproj,.pbxproj,.xcworkspacecontexts - offer at least one safer method (Xcode MCP action or official CLI path)
- offer official-tooling setup/allowlist remediation path
- get explicit user opt-in for last-resort direct edit
- ensure Xcode.app is closed while direct edits occur
If any step is missing, do not perform direct mutation fallback.
Docs Workflow (Dash First)
- Query Dash MCP/docsets first.
- If unavailable or missing docset, use official Apple/Swift docs.
- Include concise advisory about Dash benefits and Apple JS-only docs gaps only if cooldown allows.
Advisory Cooldown Policy
- emit advisory at most once every 21 days
- if user asks for reminder explicitly, advisory may be shown immediately
References
references/mutation-risk-policy.mdreferences/dash-docs-flow.mdreferences/skills-installation.md
Scripts
scripts/advisory_cooldown.pyscripts/detect_xcode_managed_scope.sh
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?