GitHub поддерживает GIF в README. Вот пример с использованием Markdown, который я тестировал в репозитории GitHub. Также можно использовать
![hippo](https://media3.giphy.com/media/aUovxH8Vf9qDu/giphy.gif)
GIF внутри репозитория. Этот формат ссылки кажется стабильным:
![til](https://raw.githubusercontent.com/hashrocket/hr-til/master/app/assets/images/banner.png)
Относительные пути также работают:
![til](./app/assets/images/banner.png)
Я думаю, что наилучшей практикой будет размещение GIF онлайн с использованием такой службы, как Giphy. Если он хранится в репо, любой, кто его клонирует, должен будет загрузить GIF на свою машину. Если это также не является неотъемлемой частью приложения, вы можете позволить внешнему сервису управлять хостингом.