add-expert_skill

Overview

This skill adds a new expert to the Remotion experts page by adding the expert photo, creating a data entry, and generating the rendered expert card. It guides the required file placements, data fields, and the render step so the expert appears correctly across docs and promo pages.

How this skill works

You add a square PNG headshot into two repo locations, then append a structured object to the experts array with contact and metadata fields. Finally, you run a render command to generate the visual card image and verify the render output. The process enforces filename and slug conventions and uses today’s date for the 'since' field.

When to use it

• Onboarding a new freelancer or expert featured on the Remotion experts page.
• Updating or adding a profile with a new photo, bio, or contact links.
• Preparing a new expert listing for marketing or documentation pages.
• When contributing to the repo and needing the generated card image to appear in docs.

Best practices

• Use a square PNG headshot saved at both required paths and ensure identical filenames.
• Create a lowercase, hyphenated slug from the full name (firstname-lastname).
• Set unused social/contact fields explicitly to null instead of omitting them.
• Set since to new Date('YYYY-MM-DD').getTime() using today’s date.
• Place the new object at the end of the experts array, before the closing bracket.
• After adding the entry, run bun render-cards in packages/docs and confirm the output shows 'Rendered experts-<slug>'

Example use cases

• Adding Jane Doe as a new expert with website and Twitter handle filled in.
• Adding an expert who only accepts videocalls: set videocall URL and null other socials.
• Updating an existing expert’s image by replacing both image files and re-running the render step.
• Adding a profile with project links inside the description using anchor tags.