CLAUDE.md · diff

git:20260407.b77ead2 to git:20260420.930f0c8

1 added, 1 removed. Audit A to A.

# 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
+ ├── commands/ # /fdk-migrate, /fdk-review, /fdk-fix, /fdk-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