CLAUDE.md git:20260407.b77ead2A

Immutable. This exact content is served forever at /api/v1/blob/0422aec271c52757.

# Freshworks Agent Skills

Skills for AI coding assistants (Claude Code, Cursor, etc.) that provide Freshworks Platform 3.0 guidance.

## Structure

```
skills/
└── app-dev/              # core skill: Platform 3.0 apps, manifest, Crayons, FDK
    ├── SKILL.md
    ├── commands/         # /migrate, /review, /fix, /refactor
    ├── references/
    └── assets/templates/
```

## Development

### Adding Skills

Create subskills that reference parent:

```markdown
---
name: "freshworks-oauth-github"
parent: app-dev
---

# GitHub OAuth Apps

**FIRST**: Use the parent `app-dev` skill for Platform 3.0 basics.

Then apply these patterns:
- GitHub OAuth config in oauth_config.json
- Scopes: repo, user
- Request templates with <%= access_token %>
```


## Security

When documenting examples, obfuscate sensitive info:

- API keys: use `your-api-key-here` or `<%= iparam.api_key %>` placeholders
- OAuth client IDs/secrets: use `client_id_placeholder`, never real values
- Domain names: use `your-domain.freshdesk.com` or `your-domain.freshservice.com`
- Never include real tokens, passwords, or credentials
- Use `<%= iparam.name %>` and `<%= oauth_iparams.name %>` for config references